Str replace: примеры (PHP)

<?
$str = 'Яблоко вкусное.';
$result = str_replace('Яблоко', 'Апельсин', $str);
echo $result; // Апельсин вкусное.
?>

Апельсин вкусное.

<?
$str = 'Собака бежит быстро.';
$search = ['Собака', 'бежит'];
$replace = ['Кошка', 'идет'];
$result = str_replace($search, $replace, $str);
echo $result; // Кошка идет быстро.
?>

Кошка идет быстро.

<?
$str = 'a a a b c';
$count = 0;
$result = str_replace('a', 'z', $str, $count);
echo $result . ' Замен: ' . $count; // z z z b c Замен: 3
?>

z z z b c Замен: 3

• str_ireplace(): Регистронезависимый аналог str_replace(). Предпочтительнее, когда важен поиск без учета регистра.
• substr_replace(): Заменяет часть строки, заданную смещением и длиной. Используется для замены по позиции, а не по содержимому.
• preg_replace(): Выполняет поиск и замену по регулярному выражению. Необходима для сложных шаблонов поиска.
• strtr(): Заменяет символы или подстроки, часто эффективнее для множественных замен фиксированных пар. Работает побайтово.

text = "Яблоко вкусное."
result = text.replace("Яблоко", "Апельсин")
print(result)  # Апельсин вкусное.

Апельсин вкусное.

Особенность: Метод строки, а не глобальная функция. Не поддерживает одновременную замену массивов, для этого используют циклы или re.sub().

let str = "Собака, собака, Собака";
// replace() меняет только первое вхождение (без флага g)
let result1 = str.replace("Собака", "Кот");
// replaceAll() меняет все вхождения
let result2 = str.replaceAll("Собака", "Кот");
console.log(result1); // Кот, собака, Собака
console.log(result2); // Кот, Кот, Кот

Кот, собака, Собака
Кот, Кот, Кот

Особенность: В JS replace() по умолчанию заменяет только первое совпадение. Для замены всех используется регулярное выражение с флагом g или метод replaceAll().

SELECT REPLACE('Исходный текст.', 'текст', 'результат');
-- Результат: Исходный результат.

Исходный результат.

Особенность: SQL-функция для работы с данными в столбцах таблиц. Используется в запросах.

<?
$str = 'a b c';
$search = ['a', 'b', 'c'];
$replace = ['x', 'y']; // Меньше элементов, чем в search
$result = str_replace($search, $replace, $str);
echo $result; // x y c
?>

x y c

Лишние элементы search заменяются на пустые строки. Это приводит к неочевидным результатам.

<?
$str = 'a b c';
$result = str_replace(['a', 'b'], ['b', 'a'], $str);
echo $result; // b a c
?>

b a c

Замена происходит последовательно для каждого элемента массива, а не за один проход. Сначала 'a' меняется на 'b', затем в новой строке 'b' меняется на 'a', что может привести к обратной замене.

<?
$str = 'test';
$result = str_replace('', 'X', $str);
echo $result; // XtXeXsXtX
?>

XtXeXsXtX

Пустая строка поиска находит позицию перед каждым символом и в конце строки, что приводит к вставке замены в этих местах.

• PHP 8.0.0: Параметр $search и $replace теперь принимают только значения типа array|string. Передача null и других недопустимых типов вызывает фатальную ошибку TypeError. Ранее null интерпретировался как пустая строка.
• PHP 7.4.0: Добавлена поддержка передачи параметра $count по ссылке, хотя это и не было строго обязательным ранее, теперь это официально задокументированное поведение.

<?
$phrases = ['Привет, мир', 'Добрый день', 'Мир прекрасен'];
$result = str_replace('мир', 'Вселенная', $phrases, $count, true);
print_r($result);
echo "Всего замен: $count\n";
?>

Array
(
    [0] => Привет, Вселенная
    [1] => Добрый день
    [2] => Вселенная прекрасен
)
Всего замен: 2

<?
$text = "PHP и php это круто";
$result = str_ireplace('php', 'Python', $text);
echo $result; // Python и Python это круто
?>

Python и Python это круто

<?
$text = "Этот плохой, ужасный, отвратительный код!";
$badWords = ['плохой', 'ужасный', 'отвратительный'];
$censored = str_replace($badWords, '***', $text);
echo $censored; // Этот ***, ***, *** код!
?>

Этот ***, ***, *** код!

<?
$str = "aaabbbccc";
$trans = ['a' => 'x', 'b' => 'y', 'c' => 'z'];
// str_replace - последовательная замена по элементам массива
$res1 = str_replace(array_keys($trans), array_values($trans), $str);
// strtr - параллельная замена (побайтовая)
$res2 = strtr($str, $trans);
echo "str_replace: $res1\n"; // str_replace: xxxyyyzzz
?>

str_replace: xxxyyyzzz
strtr: xxxyyyzzz