Deze functie vervangt alle voorkomens van needle
in haystack
met de gegeven str
.
Als je geen al te toffe vervangingsregels nodig hebt, wordt aangeraden
om altijd deze functie te gebruiken in plaats van ereg_replace()
or preg_replace().
Vanaf PHP 4.0.5 kan elk parameter van str_replace een array zijn.
Als subject
een array is, dan wordt de
vervangoperatie uitgevoerd met elk onderdeel van
subject
, en zal dan een array teruggeven.
Als search
en replace
arrays zijn, dan zal str_replace() een waarde van
beide arrays worden genomen en zal de vervangoperatie met die waarden
plaatsvinden op subject
. Als
replace
minder waarden heeft dan
search
, dan zal een lege string worden gebruikt
voor de rest van de vervangingswaarden. Als search
een array is, en replace
is een string, dan zal
die string worden gebruikt voor elke waarde van
search
.
Deze functie is binary safe.
Opmerking: str_replace() is toegevoegd in PHP 3.0.6, maar was buggy tot PHP 3.0.8.
Zie ook ereg_replace(), preg_replace() en strtr().