Описание
mixed
str_ireplace
( mixed search, mixed replace, mixed subject [, int &count] )
Эта функция возвращает строку или массив
subject
, в котором все вхождения
search
(без учета регистра символов) заменены
на replace
. Если не нужны сложные правила
поиска/замены, использование этой функции предпочтительнее
eregi_replace()
или preg_replace()
с модификатором
i
.
Если subject
- массив, поиск и замена
производится в каждом элементе этого массива, и возвращается также
массив.
Если и search
, и
replace
- массивы, то
str_ireplace()
использует все значения массива
search
и соответствующие значения массива
replace
для поиска и замены в
subject
. Если в массиве
replace
меньше элементов, чем в
search
, в качестве строки замены для
оставшихся значений будет использована пустая строка.
Если search
- массив, а
replace
- строка, то
replace
будет использована как строка замены
для каждого элемента массива search
.
Замечание:
Эта функция безопасна
для обработки данных в двоичной форме.
Замечание:
Начиная с PHP 5.0.0
количество произведенных
замен может быть получено в необязательном аргументе
count
, который передается по ссылке.
В версиях до PHP 5.0.0
этот аргумент недоступен.
См. также описание функций
str_replace()
,
ereg_replace()
,
preg_replace()
и
strtr()
.