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