PHP str_replace()Функции
Справочное руководство по строкам PHP
Примеры
Замените символы "world" в строке "Hello world!" на "Peter":
<?php
echo str_replace("world","Peter","Hello world!");
?>
echo str_replace("world","Peter","Hello world!");
?>
Запустить пример »
Определение и использование
Функция str_replace() заменяет некоторые символы в строке (с учётом регистра).
Эта функция должна следовать следующим правилам:
- Если искомая строка является массивом, возвращается массив.
- Если искомая строка является массивом, функция найдёт и заменит каждый элемент в массиве.
- Если вам нужно одновременно найти и заменить массив, и количество заменяемых элементов меньше количества найденных элементов, лишние элементы будут заменены пустой строкой.
- Если вы ищете массив, но заменяете только одной строкой, строка замены будет применена ко всем найденным значениям.
Примечание:Эта функция чувствительна к регистру. Для поиска без учета регистра используйте функциюstr_ireplace().
Примечание:Эта функция безопасна для обработки данных в двоичной форме.
Синтаксис
str_replace(find,replace,string,count)
| Параметр | Описание |
|---|---|
| найти | Обязательно. Указывает значение для поиска. |
| замена | Обязательный. Задает значение заменыfindдля значения в find. |
| string | Обязательный. Указывает строку, в которой выполняется поиск. |
| count | Необязательный. Переменная, которая подсчитывает количество замен. |
Технические детали
| Возвращаемое значение: | Возвращает строку или массив со значениями замены. |
|---|---|
| Версия PHP: | 4+ |
| Список изменений: | В PHP 5.0 был добавлен новый параметрcount. До PHP 4.3.3 параметрыfindиreplaceэтой функции, когда оба были массивами, вызывали проблемы, из-за чего пустыеfindиндексы игнорировались, когда внутренний указатель не был перемещен наreplaceмассив. В более новых версиях этой проблемы нет. Начиная с PHP 4.0.5, большинство параметров может быть массивом. |
Другие примеры
Пример 1
Используйте функцию str_replace() с массивом и переменной count:
<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Замен: $i";
?>
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Замен: $i";
?>
Запустить пример »
Пример 2
Используйте функцию str_replace() с меньшим числом элементов для замены, чем найдено элементов:
<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>
Запустить пример »
Справочное руководство по строкам PHP Другие расширения