str_ireplace - Регистронезависимый вариант функции str_replace
Вернуться к: Обработка строк
Описание
Эта функция возвращает строку или массив, в котором все
вхождения 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
-
Если передан, то будет установлен в количество произведенных замен.
Возвращаемые значения
Возвращает строку или массив с замененными значениями.
Примеры
Пример #1 Пример использования str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
Примечания
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Замечание о порядке замены
Так как str_ireplace() осуществляет замену слева направо, то при использовании множественных замен она может заменить ранее вставленное значение на другое. Пример №2 в документации str_replace() поясняет как это работает на практике.
Смотрите также
- str_replace() - Заменяет все вхождения строки поиска на строку замены
- preg_replace() - Выполняет поиск и замену по регулярному выражению
- strtr() - Преобразует заданные символы или заменяет подстроки
Вернуться к: Обработка строк