takagi Thu Jul 27 03:42:56 2006 UTC
Modified files:
/phpdoc/en/reference/mbstring/functions mb-strrpos.xml
Log:
- converted to the new doc style
- added the description of a new parameter 'offset'
- removed a note about the difference of mb_strrpos() and strrpos()
(strrpos() accepts string for 'needle' as of PHP 5)
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strrpos.xml?r1=1.2&r2=1.3&diff_format=u
Index: phpdoc/en/reference/mbstring/functions/mb-strrpos.xml
diff -u phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.2
phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.3
--- phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.2 Wed Apr 17
06:40:00 2002
+++ phpdoc/en/reference/mbstring/functions/mb-strrpos.xml Thu Jul 27
03:42:56 2006
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/mbstring.xml, last change in rev 1.1 -->
<refentry id="function.mb-strrpos">
<refnamediv>
@@ -8,12 +8,14 @@
Find position of last occurrence of a string in a string
</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>int</type><methodname>mb_strrpos</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>
@@ -32,18 +34,61 @@
</para>
<para>
If <parameter>encoding</parameter> is omitted, internal encoding
- is assumed. <function>mb_strrpos</function> accepts
- <literal>string</literal> for <parameter>needle</parameter> where
- <function>strrpos</function> accepts only character.
+ is assumed.
</para>
<para>
<parameter>encoding</parameter> is character encoding. If it is
not specified, internal character encoding is used.
</para>
+ <note>
+ <simpara>
+ As of PHP 5.2.0 <parameter>offset</parameter> may
+ be specified to begin searching an arbitrary number of characters into
+ the string. Negative values will stop searching at an arbitrary point
+ prior to the end of the string.
+ </simpara>
+ </note>
+ <note>
+ <simpara>
+ As of PHP 5.2.0 <parameter>encoding</parameter>
+ can be specified as the third parameter for
+ backward compatibility, but not recommended.
+ It is deprecated and will be removed from
+ the future release of PHP.
+ </simpara>
+ </note>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.2.0</entry>
+ <entry>Added the optional parameter
<parameter>offset</parameter>.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- See also <function>mb_strpos</function>,
- <function>mb_internal_encoding</function>,
- <function>strrpos</function>.
+ <simplelist>
+ <member><function>mb_strpos</function></member>
+ <member><function>mb_internal_encoding</function></member>
+ <member><function>strrpos</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
