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