takagi Sat Sep 23 06:34:37 2006 UTC Added files: /phpdoc/en/reference/mbstring/functions mb-strstr.xml mb-strripos.xml mb-strrichr.xml mb-strrchr.xml mb-stristr.xml mb-stripos.xml mb-check-encoding.xml Log: added the document of new functions (they'll be available as of PHP 5.2.0).
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strstr.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-strstr.xml +++ phpdoc/en/reference/mbstring/functions/mb-strstr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-strstr"> <refnamediv> <refname>mb_strstr</refname> <refpurpose>Finds first occurrence of a string within another</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>mb_strstr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>part</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_strstr</function> finds the first occurrence of <parameter>needle</parameter> in <parameter>haystack</parameter> and returns the portion of <parameter>haystack</parameter>. If <parameter>needle</parameter> is not found, it returns &false;. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> The string from which to get the first occurrence of <parameter>needle</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> The string to find in <parameter>haystack</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>part</parameter></term> <listitem> <para> Determines which portion of <parameter>haystack</parameter> this function returns. If set to &true;, it returns all of <parameter>haystack</parameter> from the beginning to the first occurrence of <parameter>needle</parameter>. If set to &false;, it returns all of <parameter>haystack</parameter> from the first occurrence of <parameter>needle</parameter> to the end, Default value is &false;. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Character encoding name to use. If it is omitted, internal character encoding is used. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns the portion of <parameter>haystack</parameter>, or &false; if <parameter>needle</parameter> is not found. </para> </refsect1>
<!-- Use when ERRORS exist <refsect1 role="errors"> &reftitle.errors; <para> When does this function throw E_* level errors, or exceptions? </para> </refsect1> --> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_strstr</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>stristr</function></member> <member><function>strstr</function></member> <member><function>mb_stristr</function></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strripos.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-strripos.xml +++ phpdoc/en/reference/mbstring/functions/mb-strripos.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-strripos"> <refnamediv> <refname>mb_strripos</refname> <refpurpose>Finds position of last occurrence of a string within another, case insensitive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>mb_strripos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_strripos</function> performs multi-byte safe <function>strripos</function> operation based on number of characters. <parameter>needle</parameter> position is counted from the beginning of <parameter>haystack</parameter>. First character's position is 0. Second character position is 1. Unlike <function>mb_strrpos</function>, <function>mb_strripos</function> is case-insensitive. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> The string from which to get the position of the last occurrence of <parameter>needle</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> The string to find in <parameter>haystack</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> The position in <parameter>haystack</parameter> to start searching </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Character encoding name to use. If it is omitted, internal character encoding is used. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Return the numeric position of the last occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string, or &false; if <parameter>needle</parameter> is not found. </para> </refsect1> <!-- Use when ERRORS exist <refsect1 role="errors"> &reftitle.errors; <para> When does this function throw E_* level errors, or exceptions? </para> </refsect1> --> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_strripos</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>strripos</function></member> <member><function>strrpos</function></member> <member><function>mb_strrpos</function></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strrichr.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-strrichr.xml +++ phpdoc/en/reference/mbstring/functions/mb-strrichr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-strrichr"> <refnamediv> <refname>mb_strrichr</refname> <refpurpose>Finds the last occurrence of a character in a string within another, case insensitive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>mb_strrichr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>part</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_strrichr</function> finds the last occurrence of <parameter>needle</parameter> in <parameter>haystack</parameter> and returns the portion of <parameter>haystack</parameter>. Unlike <function>mb_strrchr</function>, <function>mb_strrichr</function> is case-insensitive. If <parameter>needle</parameter> is not found, it returns &false;. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> The string from which to get the last occurrence of <parameter>needle</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> The string to find in <parameter>haystack</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>part</parameter></term> <listitem> <para> Determines which portion of <parameter>haystack</parameter> this function returns. If set to &true;, it returns all of <parameter>haystack</parameter> from the beginning to the last occurrence of <parameter>needle</parameter>. If set to &false;, it returns all of <parameter>haystack</parameter> from the last occurrence of <parameter>needle</parameter> to the end, Default value is &false;. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Character encoding name to use. If it is omitted, internal character encoding is used. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns the portion of <parameter>haystack</parameter>. or &false; if <parameter>needle</parameter> is not found. </para> </refsect1> <!-- Use when ERRORS exist <refsect1 role="errors"> &reftitle.errors; <para> When does this function throw E_* level errors, or exceptions? </para> </refsect1> --> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_strrichr</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mb_stristr</function></member> <member><function>mb_strrchr</function></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strrchr.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-strrchr.xml +++ phpdoc/en/reference/mbstring/functions/mb-strrchr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-strrchr"> <refnamediv> <refname>mb_strrchr</refname> <refpurpose>Finds the last occurrence of a character in a string within another</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>mb_strrchr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>part</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_strrchr</function> finds the last occurrence of <parameter>needle</parameter> in <parameter>haystack</parameter> and returns the portion of <parameter>haystack</parameter>. If <parameter>needle</parameter> is not found, it returns &false;. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> The string from which to get the last occurrence of <parameter>needle</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> The string to find in <parameter>haystack</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>part</parameter></term> <listitem> <para> Determines which portion of <parameter>haystack</parameter> this function returns. If set to &true;, it returns all of <parameter>haystack</parameter> from the beginning to the last occurrence of <parameter>needle</parameter>. If set to &false;, it returns all of <parameter>haystack</parameter> from the last occurrence of <parameter>needle</parameter> to the end, Default value is &false;. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Character encoding name to use. If it is omitted, internal character encoding is used. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns the portion of <parameter>haystack</parameter>. or &false; if <parameter>needle</parameter> is not found. </para> </refsect1> <!-- Use when ERRORS exist <refsect1 role="errors"> &reftitle.errors; <para> When does this function throw E_* level errors, or exceptions? </para> </refsect1> --> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_strrchr</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>strrchr</function></member> <member><function>mb_strstr</function></member> <member><function>mb_strrichr</function></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-stristr.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-stristr.xml +++ phpdoc/en/reference/mbstring/functions/mb-stristr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-stristr"> <refnamediv> <refname>mb_stristr</refname> <refpurpose>Finds first occurrence of a string within another, case insensitive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>mb_stristr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>part</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_stristr</function> finds the first occurrence of <parameter>needle</parameter> in <parameter>haystack</parameter> and returns the portion of <parameter>haystack</parameter>. Unlike <function>mb_strstr</function>, <function>mb_stristr</function> is case-insensitive. If <parameter>needle</parameter> is not found, it returns &false;. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> The string from which to get the first occurrence of <parameter>needle</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> The string to find in <parameter>haystack</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>part</parameter></term> <listitem> <para> Determines which portion of <parameter>haystack</parameter> this function returns. If set to &true;, it returns all of <parameter>haystack</parameter> from the beginning to the first occurrence of <parameter>needle</parameter>. If set to &false;, it returns all of <parameter>haystack</parameter> from the first occurrence of <parameter>needle</parameter> to the end, Default value is &false;. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Character encoding name to use. If it is omitted, internal character encoding is used. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns the portion of <parameter>haystack</parameter>, or &false; if <parameter>needle</parameter> is not found. </para> </refsect1> <!-- Use when ERRORS exist <refsect1 role="errors"> &reftitle.errors; <para> When does this function throw E_* level errors, or exceptions? </para> </refsect1> --> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_stristr</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>stristr</function></member> <member><function>strstr</function></member> <member><function>mb_strstr</function></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-stripos.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-stripos.xml +++ phpdoc/en/reference/mbstring/functions/mb-stripos.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-stripos"> <refnamediv> <refname>mb_stripos</refname> <refpurpose>Finds position of first occurrence of a string within another, case insensitive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>mb_stripos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_stripos</function> returns the numeric position of the first occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string. Unlike <function>mb_strpos</function>, <function>mb_stripos</function> is case-insensitive. If <parameter>needle</parameter> is not found, it returns &false;. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>haystack</parameter></term> <listitem> <para> The string from which to get the position of the first occurrence of <parameter>needle</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>needle</parameter></term> <listitem> <para> The string to find in <parameter>haystack</parameter> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> The position in <parameter>haystack</parameter> to start searching </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Character encoding name to use. If it is omitted, internal character encoding is used. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Return the numeric position of the first occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string, or &false; if <parameter>needle</parameter> is not found. </para> </refsect1> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_stripos</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>stripos</function></member> <member><function>strpos</function></member> <member><function>mb_strpos</function></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-check-encoding.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/mbstring/functions/mb-check-encoding.xml +++ phpdoc/en/reference/mbstring/functions/mb-check-encoding.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> <refentry id="function.mb-check-encoding"> <refnamediv> <refname>mb_check_encoding</refname> <refpurpose>Check if the string is valid for the specified encoding</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>mb_check_encoding</methodname> <methodparam choice="opt"><type>string</type><parameter>var</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> <function>mb_check_encoding</function> checks if the string is valid for the specified encoding. It is useful to prevent so-called "Invalid Encoding Attack". </para> <para> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>var</parameter></term> <listitem> <para> String to check. If it is omitted, this function checks all the input from the beginning of the request. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>encoding</parameter></term> <listitem> <para> Excepted encoding. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <!-- Use when ERRORS exist <refsect1 role="errors"> &reftitle.errors; <para> When does this function throw E_* level errors, or exceptions? </para> </refsect1> --> <!-- Use when a CHANGELOG exists <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>Enter the PHP version of change here</entry> <entry>Description of change</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> --> <!-- Use when examples exist <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>mb_check_encoding</function> example</title> <para> Any text that describes the purpose of the example, or what goes on in the example should go here (inside the <example> tag, not out </para> <programlisting role="php"> <![CDATA[ <?php if ($anexample === true) { echo 'Use the PEAR Coding Standards'; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Use the PEAR Coding Standards ]]> </screen> </example> </para> </refsect1> --> <!-- Use when adding See Also links <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function></function></member> <member>Or <link linkend="somethingelse">something else</link></member> </simplelist> </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 -->