(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().