mb_ereg_replace

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_ereg_replaceЗаменяет по регулярному выражению с поддержкой многобайтовых кодировок

Описание

mb_ereg_replace(
    string $pattern,
    string $replacement,
    string $string,
    ?string $options = null
): string|false|null

Сканирует строку string для поиска совпадений с шаблоном pattern, затем заменяет совпавший текст на значение параметра replacement.

Список параметров

pattern

Шаблон регулярного выражения.

В шаблоне pattern можно указывать многобайтовые символы.

replacement

Текст замены.

string

Проверяемая строка (string).

options
Вариант поиска. Объяснение дано в описании функции mb_regex_set_options().

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

Возвращает результирующую строку в случае успешного выполнения или false в случае возникновения ошибки. Если строка string недопустима для текущей кодировки, возвращается значение null.

Список изменений

Версия Описание
8.0.0 Параметр options теперь может принимать значение null.
7.1.0 Функция проверяет, допустима ли строка string для текущей кодировки.
7.1.0 Модификатор e объявлен устаревшим.

Примечания

Замечание:

Для этой функции будет использована внутренняя кодировка или кодировка, установленная функцией mb_regex_encoding().

Внимание

Никогда не используйте модификатор e при работе с данными, полученными из недостоверных источников. Не выполняется никакого автоматического экранирования этих данных (в отличие от preg_replace()). Игнорирование этих требований, скорее всего, создаст уязвимость выполнения удалённого кода в приложении.

Смотрите также

  • mb_regex_encoding() - Устанавливает или получает кодировку символов для многобайтового регулярного выражения
  • mb_eregi_replace() - Заменяет по регулярному выражению с поддержкой многобайтовых символов без учёта регистра