str_replace

(PHP 3 >= 3.0.6, PHP4, PHP 5)str_replace -- Заменяет строку поиска на строку замены

Описание

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

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

- С версии PHP4.0.5, любой аргумент str_replace() может быть массивом.

Внимание
- В версиях младше 4.3.3 эта функция содержит ошибку при одновременной передаче массивов в аргументах search и replace. Ошибка заключается в том, что пустые элементы массива search пропускались без перемещения к следующему элементу массива replace. Эта ошибка была исправлена в PHP4.3.3. Если ваши скрипты использовали эту ошибку, то в них нужно удалить пустые элементы из массива search перед вызовом этой функции.

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

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

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

<? //присваивает <body text='black'> $bodytag = str_replace("%body%", "black", "<body text='%body%'>"); //присваивает: Hll Wrld f PHP $vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U"); $onlyconsonants = str_replace($vowels, "", "Hello World of PHP"); //присваивает: You should eat pizza, beer, and ice cream every day $phrase = "You should eat fruits, vegetables, and fiber every day."; $healthy = array("fruits", "vegetables", "fiber"); $yummy = array("pizza", "beer", "ice cream"); $newphrase = str_replace($healthy, $yummy, $phrase); //начиная с версии 5.0.0 доступен аргумент count $str = str_replace("ll", "", "good golly miss molly!", $count); echo $count; //2
?>

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

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

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

str_repeat

str_rot13 22222