(PHP 3 >= 3.0.6, PHP 4, PHP 5)
str_replace -- Erstatter alle forekomster af søgestrengen med erstatningsstrengen.
Denne funktion returnerer en streng eller et array med alle forekomster
af search i subject
erstattet med den givne replace-værdi. Hvis du
ikke skal bruge smarte erstatningsregler (som regulære udtryk), bør du
altid bruge denne funktion i stedet for ereg_replace()
eller preg_replace().
Siden PHP 4.0.5, kan ethvert parameter i str_replace() være et array.
| Advarsel |
I PHP-versioner tidligere end 4.3.3 eksisterede der en fejl når man
brugte arrays både som |
Hvis subject er et array, bliver søgningen og
erstatningen udført på hvert element i subject,
og returværdien bliver også et array.
Hvis search og replace er
arrays, så tager str_replace() én værdi fra hver array
og bruger dem til at foretage søg og erstat på
subject. Hvis replace har
færre værdier end search, så bliver der brugt en
tom streng til resten af erstatningerne. Hvis
search er et array og
replace er en streng, så vil denne erstatning
blive brugt for hvert element i search. Det
omvendte ville dog ikke give mening.
Bemærk: Denne funktion er binary-safe.
Bemærk: Fra og med PHP 5.0.0 vil antallet af matchede og erstattede udtryk (
search) blive returneret icount, som bliver givet via reference. Før PHP 5.0.0 var denne parameter ikke tilgængelig.
Se også str_ireplace(), substr_replace(), ereg_replace(), preg_replace() og strtr().