str_replace

(PHP 3>= 3.0.6, PHP 4)

str_replace - замещает все вхождения строки поиска строкой замещения.

Описание

mixed str_replace (mixed search, mixed replace, mixed subject)

Эта функция возвращает строку или массив со всеми вхождениями search в subject , заменёнными данным значением replace . Если вам не нужны какие-то особые правила замещения, вы всегда должны использовать эту функцию вместо ereg_replace() или preg_replace() .

В PHP 4.0.5 и новее каждый параметр для str_replace() может быть массивом.

Если subject это массив, то поиск и замена выполняется с каждым вхождением subject , а return-значение также является массивом.

Если search и replace это массивы, то str_replace() принимает значение из каждого массива и использует его для поиска и замены в subject . Если replace имеет меньше значений, чем search , то пустая строка используется для остальных замещающих значений. Если search это массив, а replace - строка, то эта строка замещения используется для каждого значения search .

Эта функция бинарно безопасна/binary safe.

Примечание: str_replace() была введена в PHP 3.0.6, но была с багами до PHP 3.0.8.

См. также ereg_replace() , preg_replace() и strtr() .