Руководство по PHP
Пред. |  | След.

# str_ireplace

(PHP 5)

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

## Описание

mixed str_ireplace ( mixed search, mixed replace, mixed subject [, int &count] )

Эта функция возвращает строку или массив `subject`, в котором все вхождения `search` (без учета регистра символов) заменены на `replace`. Если не нужны сложные правила поиска/замены, использование этой функции предпочтительнее eregi_replace() или preg_replace() с модификатором `i`.

Если `subject` - массив, поиск и замена производится в каждом элементе этого массива, и возвращается также массив.

Если и `search`, и `replace` - массивы, то str_ireplace() использует все значения массива `search` и соответствующие значения массива `replace` для поиска и замены в `subject`. Если в массиве `replace` меньше элементов, чем в `search`, в качестве строки замены для оставшихся значений будет использована пустая строка. Если `search` - массив, а `replace` - строка, то `replace` будет использована как строка замены для каждого элемента массива `search`.

Пример 1. Пример использования str_ireplace()

`<?php $bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>"); ?>`

> Замечание: Эта функция безопасна для обработки данных в двоичной форме.

> Замечание: Начиная с `PHP 5.0.0` количество произведенных замен может быть получено в необязательном аргументе `count`, который передается по ссылке. В версиях до `PHP 5.0.0` этот аргумент недоступен.

См. также описание функций str_replace(), ereg_replace(), preg_replace() и strtr().

Пред. | Начало | След.
sscanf | Уровень выше | str_pad