Funktio str_replace

Funktio str_replace etsii merkkijonosta määritetyn tekstin ja korvaa sen toisella. Ensimmäisenä parametrina funktio ottaa sen, mitä korvataan, ja toisena - mihin korvataan. Nämä voivat olla kaksi merkkijonoa tai kaksi taulukkoa. Jälkimmäisessä tapauksessa vastaavat alkioit toisesta taulukosta korvautuvat vastaavilla alkioilla toisesta taulukosta (ks. esimerkit).

Syntaksi

str_replace(array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array

Esimerkki

Korvataan kaikki kirjaimet 'a' kirjaimilla '!':

<?php
	echo str_replace('a', '!', 'abcabc');
?>

Koodin suorituksen tulos:

'!bc!bc'

Esimerkki

Korvataan kaikki kirjaimet 'a' luvuilla 1, kirjaimet 'b' luvuilla 2, kirjaimet 'c' luvuilla 3:

<?php
	echo str_replace(['a', 'b', 'c'], [1, 2, 3], 'abcabc');
?>

Koodin suorituksen tulos:

'123123'

Esimerkki

Korvataan annetut kirjaimet yhdellä yhteisellä määritellyllä merkillä:

<?php
	echo str_replace(['a', 'b', 'c'], '!', 'abcabc');
?>

Koodin suorituksen tulos:

'!!!!!!'

Esimerkki

Suoritetaan korjaus jokaisessa taulukon alkiossa:

<?php
	$arr = ['abc', 'abc', 'abc'];
	$res = str_replace('a', '!', $arr);
	print_r($res);
?>

Koodin suorituksen tulos:

['!bc', '!bc', '!bc']

Esimerkki

Kirjainkoko on merkitsevä:

<?php
	echo str_replace('a', '!', 'Abcabc');
?>

Koodin suorituksen tulos:

'Abc!bc'

Katso myös

funktion str_ireplace,
joka suorittaa haun ja korvauksen kirjainkoosta riippumatta
funktion strtr,
joka myös suorittaa haun ja korvauksen
funktion substr_replace,
joka leikkaa osan merkkijonosta ja korvaa sen toisella