Function.glob

Aus PHP-Wiki

glob — Find pathnames matching a pattern

Beschreibung

array glob ( string $pattern [, int $flags ] )

The glob() function searches for all the pathnames matching pattern according to the rules used by the libc glob() function, which is similar to the rules used by common shells.

Parameter-Liste

pattern

• The pattern. No tilde expansion or parameter substitution is done.

flags

• Valid flags: GLOB_MARK - Adds a slash to each directory returned GLOB_NOSORT - Return files as they appear in the directory (no sorting) GLOB_NOCHECK - Return the search pattern if no files matching it were found GLOB_NOESCAPE - Backslashes do not quote metacharacters GLOB_BRACE - Expands {a,b,c} to match 'a', 'b', or 'c' GLOB_ONLYDIR - Return only directory entries which match the pattern GLOB_ERR - Stop on read errors (like unreadable directories), by default errors are ignored.

Rückgabewerte

Returns an array containing the matched files/directories, an empty array if no file matched or FALSE on error. Hinweis: On some systems it is impossible to distinguish between empty match and an error.

ChangeLog

Version Beschreibung 5.1.0 GLOB_ERR was added 4.3.3 GLOB_ONLYDIR became available on Windows and other systems not using the GNU C library

Beispiele

Beispiel #1 Convenient way how glob() can replace opendir() and friends.

<?php
foreach (glob("*.txt") as $filename) {
    echo "$filename size " . filesize($filename) . "\n";
}
?>

Das oben gezeigte Beispiel erzeugt
eine ähnliche Ausgabe wie:

funclist.txt size 44686
funcsummary.txt size 267625
quickref.txt size 137820

Anmerkungen

Hinweis: Diese Funktion kann nicht mit entfernten Dateien arbeiten, da der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des Servers möglich sein muss. Hinweis: This function isn't available on some systems (e.g. old Sun OS). Hinweis: The GLOB_BRACE flag is not available on some non GNU systems, like Solaris.

Siehe auch

• opendir()
• readdir()
• closedir()
• fnmatch()