Функция PHP preg_replace()
❮ Справочник по регулярному выражению PHP
Пример
Используйте регулярное выражение без учета регистра, чтобы заменить Microsoft на W3Schools в строке:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Определение и использование
Функция preg_replace()
возвращает строку или массив строк, где все совпадения шаблона или списка шаблонов, найденных во входных данных, заменены подстроками.
Существует три различных способа использования этой функции:
1. Один шаблон и сменная строка. Совпадения шаблона заменяются строкой замены.
2. Массив шаблонов и строка замены. Совпадения любого из шаблонов заменяются строкой замены.
3. Массив шаблонов и массив замещающих строк. Совпадения каждого шаблона заменяются строкой замены в той же позиции в массиве замен. Если в этой позиции не найдено ни одного элемента, совпадение заменяется пустой строкой.
Строки замены могут содержать обратную ссылку в форме \n или $n, где n — индекс группы в шаблоне. В возвращаемой строке экземпляры \n и $n будут заменены подстрокой, совпавшей с группой, или, если используются \0 или $0, всем выражением.
Примечание. Для каждой входной строки функция оценивает шаблоны в том порядке, в котором они заданы. Результат вычисления первого шаблона в строке используется в качестве входной строки для второго шаблона и так далее. Это может привести к неожиданному поведению.
Синтаксис
preg_replace(patterns, replacements, input, limit, count)
Значения параметров
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Технические детали
Возвращаемое значение: | Возвращает строку или массив строк, полученных в результате применения замен к входной строке или строкам. |
---|---|
Версия PHP: | 4.0.5+ |
Список изменений: | PHP 5.1.0 - Добавлен параметр count |
❮ Справочник по регулярному выражению PHP