[PHP-DOC] cvs: phpdoc /en/reference/strings/functions str-replace.xml

[Tom Sommer]

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>