php-str_ireplace

  • 08.07.2026
  • admin
  • 1минут читать

<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() .