$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() показывает, как работают замены.