Эта функция возвращает строку или массив
subject
, в котором все вхождения
search
заменены
на replace
. Если не нужны сложные правила
поиска/замены, использование этой функции предпочтительнее
ereg_replace()
или preg_replace().
С версии PHP 4.0.5, любой аргумент str_replace() может быть массивом.
Внимание |
В версиях младше 4.3.3 эта функция содержит ошибку при одновременной
передаче массивов в аргументах |
Если subject
- массив, поиск и замена
производится в каждом элементе этого массива, и возвращается также
массив.
Если и search
, и
replace
- массивы, то
str_replace() использует все значения массива
search
и соответствующие значения массива
replace
для поиска и замены в
subject
. Если в массиве
replace
меньше элементов, чем в
search
, в качестве строки замены для
оставшихся значений будет использована пустая строка.
Если search
- массив, а
replace
- строка, то
replace
будет использована как строка замены
для каждого элемента массива search
.
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Замечание: Начиная с PHP 5.0.0 количество произведенных замен может быть получено в необязательном аргументе
count
, который передается по ссылке. В версиях до PHP 5.0.0 этот аргумент недоступен.
См. также описание функций str_ireplace(), substr_replace(), ereg_replace(), preg_replace() и strtr().
Пред. | Начало | След. |
str_repeat | Уровень выше | str_rot13 |