GLOB(3) 								 1								   GLOB(3)

glob - Find pathnames matching a pattern

SYNOPSIS

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

DESCRIPTION

	The  glob(3)  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.

PARAMETERS

	      o $pattern
		- The pattern. No tilde expansion or parameter substitution is done.

	      o $flags
		- Valid flags:

		     o GLOB_MARK - Adds a slash to each directory returned

		     o GLOB_NOSORT - Return files as they appear in the directory (no sorting). When this flag is  not	used,  the  pathnames  are
		       sorted alphabetically

		     o GLOB_NOCHECK - Return the search pattern if no files matching it were found

		     o GLOB_NOESCAPE - Backslashes do not quote metacharacters

		     o GLOB_BRACE - Expands {a,b,c} to match 'a', 'b', or 'c'

		     o GLOB_ONLYDIR - Return only directory entries which match the pattern

		     o GLOB_ERR - Stop on read errors (like unreadable directories), by default errors are ignored.

RETURN VALUES

	Returns an array containing the matched files/directories, an empty array if no file matched or FALSE on error.

       Note

	       On some systems it is impossible to distinguish between empty match and an error.

CHANGELOG

       +--------+--------------------+
       |Version |		     |
       |	|		     |
       |	|    Description     |
       |	|		     |
       +--------+--------------------+
       | 5.1.0	|		     |
       |	|		     |
       |	|		     |
       |	| GLOB_ERR was added |
       |	|		     |
       +--------+--------------------+
EXAMPLES

       Example #1

	       Convenient way how glob(3) can replace opendir(3) and friends.

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

	      The above example will output something similar to:

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

NOTES

       Note

	      This function will not work on remote files as the file to be examined must be accessible via the server's filesystem.

       Note

	       This function isn't available on some systems (e.g. old Sun OS).

       Note

	       The GLOB_BRACE flag is not available on some non GNU systems, like Solaris.

SEE ALSO

       opendir(3), readdir(3), closedir(3), fnmatch(3).

PHP Documentation Group 														   GLOB(3)