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

tomsommer Mon Jun 14 05:45:09 2004 EDT Modified files: /phpdoc/en/reference/strings/functions str-replace.xml Log: Back out bogus commit. Remind me to smack Mr. Holst http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/str-replace.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/strings/functions/str-replace.xml diff -u phpdoc/en/reference/strings/functions/str-replace.xml:1.14 phpdoc/en/reference/strings/functions/str-replace.xml:1.15 --- phpdoc/en/reference/strings/functions/str-replace.xml:1.14 Mon Jun 14 03:42:44 2004 +++ phpdoc/en/reference/strings/functions/str-replace.xml Mon Jun 14 05:45:09 2004 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- Revision: 1.13 Maintainer: tomsommer Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.str-replace"> <refnamediv> <refname>str_replace</refname> <refpurpose> - Erstatter alle forekomster af søgestrengen med erstatningsstrengen. + Replace all occurrences of the search string with the replacement string </refpurpose> </refnamediv> <refsect1> @@ -18,44 +18,47 @@ <methodparam choice="opt"><type>int</type><parameter>&amp;count</parameter></methodparam> </methodsynopsis> <para> - Denne funktion returnerer en streng eller et array med alle forekomster - af <parameter>search</parameter> i <parameter>subject</parameter> - erstattet med den givne <parameter>replace</parameter>-værdi. Hvis du - ikke skal bruge smarte erstaningsregler (som regulære udtryk), bør du - altid bruge denne funktion i stedet for <function>ereg_replace</function> - eller <function>preg_replace</function>. + This function returns a string or an array with all occurrences of + <parameter>search</parameter> in <parameter>subject</parameter> + replaced with the given <parameter>replace</parameter> value. If you + don't need fancy replacing rules (like regular expressions), you should + always use this function instead of <function>ereg_replace</function> or + <function>preg_replace</function>. </para> <para> - Siden PHP 4.0.5, kan ethvert parameter i <function>str_replace</function> - være et <type>array</type>. + As of PHP 4.0.5, every parameter in <function>str_replace</function> + can be an <type>array</type>. </para> <warning> <simpara> - I PHP-versioner tidligere end 4.3.3 eksisterede der en fejl når man - brugte arrays både som <parameter>search</parameter>- og <parameter>replace</parameter> - parametre hvilket forårsagede at tomme - <parameter>search</parameter>-indekser blev ignoreret, uden at følge med - i hvor pointeren var placeret i <parameter>replace</parameter>-arrayet. - Dette er blevet rettet i <literal>PHP 4.3.3</literal>, alle scripts der - hvilket på denne fejl skulle fjerne tomme søgeværdier tidligere for at - få funktionen til at opføre sig som den bør. + In PHP versions prior to 4.3.3 a bug existed when using arrays as + both <parameter>search</parameter> and <parameter>replace</parameter> + parameters which caused empty <parameter>search</parameter> indexes + to be skipped without advancing the internal pointer on the + <parameter>replace</parameter> array. This has been corrected in + <literal>PHP 4.3.3</literal>, any scripts which relied on this bug + should remove empty search values prior to calling this function in + order to mimick the original behavior. </simpara> </warning> <para> - Hvis <parameter>subject</parameter> er et array, så bliver søgningen og - erstatningen udført med hvert element i <parameter>subject</parameter>, - og returværdien bliver også et array. + 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> - Hvis <parameter>search</parameter> og <parameter>replace</parameter> er - arrays, så tager <function>str_replace</function> én værdi fra hver array - og bruger dem til at foretage søg og erstat på - <parameter>subject</parameter>. Hvis <parameter>replace</parameter> har - færre værdier end <parameter>search</parameter>, så bliver der brugt en - tom streng til resten af erstatningerne. Hvis - <parameter>search</parameter> er et array og - <parameter>replace</parameter> er en streng; så vil denne erstatning - blive brugt for hvert element i <parameter>search</parameter>. + If <parameter>search</parameter> and + <parameter>replace</parameter> are arrays, then + <function>str_replace</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> @@ -63,21 +66,21 @@ <programlisting role="php"> <![CDATA[ <?php -// Giver: <body text='black'> +// Provides: <body text='black'> $bodytag = str_replace("%body%", "black", "<body text='%body%'>"); -// Giver: Hll Wrld f PHP +// Provides: Hll Wrld f PHP $vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U"); $onlyconsonants = str_replace($vowels, "", "Hello World of PHP"); -// Giver: Du skulle spise pizza, øl og is hver dag. You should eat pizza, beer, and ice cream every day -$phrase = "Du skulle spise frugter, grønsager og fiber hver dag."; -$healthy = array("frugter", "grønsager", "fiber"); -$yummy = array("pizza", "øl", "is"); +// Provides: You should eat pizza, beer, and ice cream every day +$phrase = "You should eat fruits, vegetables, and fiber every day."; +$healthy = array("fruits", "vegetables", "fiber"); +$yummy = array("pizza", "beer", "ice cream"); $newphrase = str_replace($healthy, $yummy, $phrase); -// Brugen af count-parametren er tilgængelig fra PHP 5.0.0 +// Use of the count parameter is available as of PHP 5.0.0 $str = str_replace("ll", "", "good golly miss molly!", $count); echo $count; // 2 ?> @@ -90,19 +93,18 @@ <note> <simpara> - Siden <literal>PHP 5.0.0</literal> vil antallet af matchede og erstatne - krav (<parameter>search</parameter>) blive returneret i - <parameter>count</parameter>, som bliver givet via reference. - Tidligere end <literal>PHP 5.0.0</literal> var denne parameter ikke - tilgængelig. + As of <literal>PHP 5.0.0</literal> the number of matched and replaced + needles (<parameter>search</parameter>) will be returned in + <parameter>count</parameter> which is passed by reference. + Prior to <literal>PHP 5.0.0</literal> this parameter is not available. </simpara> </note> <para> - Se også + See also <function>str_ireplace</function>, <function>substr_replace</function>, <function>ereg_replace</function>, - <function>preg_replace</function> og + <function>preg_replace</function>, and <function>strtr</function>. </para> </refsect1>