hholzgra Wed Sep 25 20:31:29 2002 EDT
Added files:
/phpdoc/en/reference/filesystem/functions fnmatch.xml
Modified files:
/phpdoc/en/reference/filesystem/functions glob.xml
Log:
glob() and fnmatch() updates
Index: phpdoc/en/reference/filesystem/functions/glob.xml
diff -u phpdoc/en/reference/filesystem/functions/glob.xml:1.3
phpdoc/en/reference/filesystem/functions/glob.xml:1.4
--- phpdoc/en/reference/filesystem/functions/glob.xml:1.3 Sun May 19 12:10:02
2002
+++ phpdoc/en/reference/filesystem/functions/glob.xml Wed Sep 25 20:31:29 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<refentry id="function.glob">
<refnamediv>
<refname>glob</refname>
@@ -21,13 +21,6 @@
Returns an array containing the matched files/directories or &false; on
error.
</para>
- <note>
- <para>
- This function is disabled in <link
- linkend="ini.safe-mode">safe mode</link> and therefore will always
- return &false; in <link linkend="ini.safe-mode">safe mode</link>.
- </para>
- </note>
<example>
<title>
Convenient way how <function>glob</function> can replace
@@ -52,7 +45,9 @@
<para>
See also <function>opendir</function>,
<function>readdir</function> and
- <function>closedir</function>.
+ <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 -->).
</para>
</refsect1>
</refentry>
Index: phpdoc/en/reference/filesystem/functions/fnmatch.xml
+++ phpdoc/en/reference/filesystem/functions/fnmatch.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fnmatch">
<refnamediv>
<refname>fnmatch</refname>
<refpurpose>Match filename against a pattern</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>fnmatch</methodname>
<methodparam><type>string</type><parameter>pattern</parameter></methodparam>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
<function>fnmatch</function> checks if the passed <parameter>string</parameter>
would
match the given shell wildcard <parameter>pattern</parameter>.
</para>
<para>
This is especialy usefull for filenames, but may also be used on regular strings.
The average user may be used to shell patterns or at least in their simplest form
to <literal>'?'</literal> and <literal>'*'</literal> wildcards so using
<function>fnmatch</function> instead of <function>ereg</function> or
<function>preg_match</function> for frontend search expression input may be
way more convenient for non-programming users.
</para>
<example>
<title>
Checking a color name against a shell wildcard pattern.
</title>
<programlisting role="php">
<![CDATA[
if(fnmatch("*gr[ae]y", $color)) {
echo "some form of gray ...";
}
]]>
</programlisting>
</example>
<para>
See also <function>glob</function>,
<function>ereg</function>,
<function>preg_match</function>
and the unix manpage on <literal>fnmatch(3)</literal> for flag names
(as long as they are not documented here <!-- TODO hartmut -->).
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
