str_replace
Заменяет все вхождения подстроки на другую строку.
Доступно с: PHP 4
Синтаксис
str_replace(
array|string $search,
array|string $replace,
string|array $subject,
int &$count = null
): string|arrayПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $search | array|string | Что искать. Можно передать массив — тогда ищутся все его элементы. |
| $replace | array|string | На что заменить. Строка или массив замен, соответствующих элементам $search. |
| $subject | string|array | Строка или массив строк, в которых выполняется поиск. |
| $count | int | Необязательный. В эту переменную записывается количество выполненных замен. |
Возвращаемое значение
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 — кавычки, склейка, длина, поиск, замена и функции для кириллицы.