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

# str_ireplace

(PHP 5, PHP 7, PHP 8)

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

### Описание

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

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

- str_replace() - Заменяет вхождения строки поиска строкой замены
- preg_replace() - Выполняет поиск и замену по регулярному выражению
- strtr() - Заменяет символы или подстроки

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open