Эта функция возвращает строку или массив, в котором все
вхождения search в subject
заменены на replace (без учета регистра символов).
Если не нужны сложные правила поиска/замены, использование этой
функции предпочтительнее preg_replace() с модификатором
i.
Если search и replace
- массивы, то str_ireplace() использует каждое
значение из соответствующего массива для поиска и замены в
subject. Если в массиве
replace меньше элементов, чем в
search, в качестве строки замены для
оставшихся значений будет использована пустая строка.
Если search - массив, а
replace - строка, то
эта строка замены будет использована для каждого элемента
массива search. Обратный случай смысла
не имеет.
Если search или
replace являются массивами, их элементы
будут обработаны от первого к последнему.
search
Искомое значение, также известное как needle (иголка). Для множества искомых значений можно использовать массив.
replace
Значение замены, будет использовано для замены искомых значений
search. Для множества значений можно использовать
массив.
subject
Строка или массив, в котором производится поиск и замена, также известный как haystack (стог сена).
Если subject является массивом, то поиск
с заменой будет осуществляться над каждым элементом
subject, а результатом функции также
будет являться массив.
count
Если передан, то будет установлен в количество произведенных замен.
Возвращает строку или массив с замененными значениями.
| Версия | Описание |
|---|---|
| 5.0.0 |
Добавлен параметр count.
|
Пример #1 Пример использования str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Так как str_ireplace() осуществляет замену слева направо, то при использовании множественных замен она может заменить ранее вставленное значение на другое. Пример №2 в документации str_replace() поясняет как это работает на практике.