cvs: phpdoc /en/reference/filesystem/functions glob.xml
| From: | John Coggeshall | Date: | Wed, 13 Nov 2002 23:36:37 +0000 |
| Subject: | cvs: phpdoc /en/reference/filesystem/functions glob.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969349639@lists.php.net to get a copy of this message | ||
john Wed Nov 13 18:36:37 2002 EDT
Modified files:
/phpdoc/en/reference/filesystem/functions glob.xml
Log:
Documented the valid flags for the glob() function, including the
two new flags I added to the source (GLOB_ONLYDIR and GLOB_BRACE).
Other flags documented:
GLOB_MARK
GLOB_NOSORT
GLOB_NOCHECK
GLOB_NOESCAPE
GLOB_BRACE
GLOB_ONLYDIR
Index: phpdoc/en/reference/filesystem/functions/glob.xml
diff -u phpdoc/en/reference/filesystem/functions/glob.xml:1.4
phpdoc/en/reference/filesystem/functions/glob.xml:1.5
--- phpdoc/en/reference/filesystem/functions/glob.xml:1.4 Wed Sep 25 20:31:29 2002
+++ phpdoc/en/reference/filesystem/functions/glob.xml Wed Nov 13 18:36:37 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.glob">
<refnamediv>
<refname>glob</refname>
@@ -21,6 +21,29 @@
Returns an array containing the matched files/directories or &false; on
error.
</para>
+ <para> <!-- Added by john (john@php.net) //-->
+ Valid flags:
+ <itemizedlist>
+ <listitem>
+ <simpara>GLOB_MARK - Adds a slash to each item returned</simpara>
+ </listitem>
+ <listitem>
+ <simpara>GLOB_NOSORT - Return files as they appear in the directory (no
sorting)</simpara>
+ </listitem>
+ <listitem>
+ <simpara>GLOB_NOCHECK - Return the search pattern if no files matching it were
found</simpara>
+ </listitem>
+ <listitem>
+ <simpara>GLOB_NOESCAPE - Backslashes do not quote metacharacters</simpara>
+ </listitem>
+ <listitem>
+ <simpara>GLOB_BRACE - Expands {a,b,c} to match 'a', 'b', or
'c' (PHP >= 4.3.0)</simpara>
+ </listitem>
+ <listitem>
+ <simpara>GLOB_ONLYDIR - Return only directory entries which match the pattern (PHP
>= 4.3.0)</simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
<example>
<title>
Convenient way how <function>glob</function> can replace
@@ -45,9 +68,7 @@
<para>
See also <function>opendir</function>,
<function>readdir</function> and
- <function>closedir</function>, <function>fnmatch</function>
- and the unix manpage on <literal>glob(3)</literal> for flag names
- (as long as they are not documented here <!-- TODO hartmut -->).
+ <function>closedir</function>, <function>fnmatch</function>.
</para>
</refsect1>
</refentry>