array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.str-ireplace.php', 1 => 'str_ireplace', 2 => 'Регистронезависимый вариант функции str_replace', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.str-increment.php', 1 => 'str_increment', ), 'next' => array ( 0 => 'function.str-pad.php', 1 => 'str_pad', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/str-ireplace.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — Регистронезависимый вариант функции str_replace()

Описание

str_ireplace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

Функция возвращает строку или массив, в котором заменила вхождения подстроки 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() показывает, как работают замены.

Смотрите также