Encodera

Спасибо, что читаете!

Пожертвуйте сайту, мы стараемся ради вас.

Справочник PHP

str_replace

Заменяет все вхождения подстроки на другую строку.

Доступно с: PHP 4

Синтаксис

str_replace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

Параметры

ПараметрТипОписание
$searcharray|stringЧто искать. Можно передать массив — тогда ищутся все его элементы.
$replacearray|stringНа что заменить. Строка или массив замен, соответствующих элементам $search.
$subjectstring|arrayСтрока или массив строк, в которых выполняется поиск.
$countintНеобязательный. В эту переменную записывается количество выполненных замен.

Возвращаемое значение

string|arrayСтрока или массив с выполненными заменами.

Примеры

Простая замена:

<?php
 
echo str_replace('world', 'PHP', 'Hello, world!');

Результат:

Hello, PHP!

Несколько замен за один вызов:

<?php
 
echo str_replace(['a', 'b'], ['1', '2'], 'abc');

Результат:

12c

Подсчёт выполненных замен:

<?php
 
str_replace('o', '0', 'foo boo', $count);
 
echo $count;

Результат:

4

Примечания

Функция чувствительна к регистру. Для замены без учёта регистра есть str_ireplace().

См. также

  • str_contains — Проверяет, содержит ли строка заданную подстроку.
  • trim — Удаляет пробелы и другие символы с начала и конца строки.

Вопросы и ответы по теме

В учебнике

  • Строки — Работа со строками в PHP — кавычки, склейка, длина, поиск, замена и функции для кириллицы.

Спасибо, что читаете!

Пожертвуйте сайту, мы стараемся ради вас.