cvs: phpdoc /en/reference/strings/functions str-ireplace.xml str-replace.xml

pollita Thu Jan 30 00:25:37 2003 EDT Added files: /phpdoc/en/reference/strings/functions str-ireplace.xml Modified files: /phpdoc/en/reference/strings/functions str-replace.xml Log: New function str_ireplace() Index: phpdoc/en/reference/strings/functions/str-replace.xml diff -u phpdoc/en/reference/strings/functions/str-replace.xml:1.2 phpdoc/en/reference/strings/functions/str-replace.xml:1.3 --- phpdoc/en/reference/strings/functions/str-replace.xml:1.2 Wed Apr 17 02:44:22 2002 +++ phpdoc/en/reference/strings/functions/str-replace.xml Thu Jan 30 00:25:37 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.str-replace"> <refnamediv> @@ -67,8 +67,11 @@ </para> </note> <para> - See also <function>ereg_replace</function>, - <function>preg_replace</function>, and <function>strtr</function>. + See also : + <function>str_ireplace</function>, + <function>ereg_replace</function>, + <function>preg_replace</function>, and + <function>strtr</function>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/strings/functions/str-ireplace.xml +++ phpdoc/en/reference/strings/functions/str-ireplace.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.str-ireplace"> <refnamediv> <refname>str_ireplace</refname> <refpurpose> Case-insensitive version of <function>str_replace</function>. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>str_ireplace</methodname> <methodparam><type>mixed</type><parameter>search</parameter></methodparam> <methodparam><type>mixed</type><parameter>replace</parameter></methodparam> <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> </methodsynopsis> <para> This function returns a string or an array with all occurences of <parameter>search</parameter> in <parameter>subject</parameter> (ignoring case) replaced with the given <parameter>replace</parameter> value. If you don't need fancy replacing rules, you should generally use this function instead of <function>eregi_replace</function> or <function>preg_replace</function> with the <literal>i</literal> modifier. </para> <para> If <parameter>subject</parameter> is an array, then the search and replace is performed with every entry of <parameter>subject</parameter>, and the return value is an array as well. </para> <para> If <parameter>search</parameter> and <parameter>replace</parameter> are arrays, then <function>str_ireplace</function> takes a value from each array and uses them to do search and replace on <parameter>subject</parameter>. If <parameter>replace</parameter> has fewer values than <parameter>search</parameter>, then an empty string is used for the rest of replacement values. If <parameter>search</parameter> is an array and <parameter>replace</parameter> is a string; then this replacement string is used for every value of <parameter>search</parameter>. </para> <para> <example> <title><function>str_ireplace</function> example</title> <programlisting role="php"> <![CDATA[ $bodytag = str_replace("%body%", "black", "<body text=%BODY%>"); ]]> </programlisting> </example> </para> <para> This function is binary safe. </para> <para> See also: <function>str_replace</function>, <function>ereg_replace</function>, <function>preg_replace</function>, and <function>strtr</function>. </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 -->