Функция PHP preg_filter()
❮ Справочник по регулярному выражению PHP
Пример
Оберните числа в скобках в список строк:
<?php
$input = [
"It is 5 o'clock",
"40 days",
"No
numbers here",
"In the year 2000"
];
$result =
preg_filter('/[0-9]+/', '($0)', $input);
print_r($result);
?>
Определение и использование
Функция preg_filter()
возвращает строку или массив строк, в которых совпадения шаблона были заменены строкой замены.
Если ввод представляет собой массив, эта функция возвращает массив. Если ввод является строкой, эта функция возвращает строку.
Эта функция аналогична preg_replace()
с одним отличием: если во входной строке не найдено совпадения с шаблоном, эта строка не будет использоваться в возвращаемом значении. В этом случае, если входные данные представляют собой строку вместо массива, функция возвращает значение null .
Строки замены могут содержать обратные ссылки в форме \n или $n, где n — индекс группы в шаблоне. В возвращаемой строке экземпляры \n и $n будут заменены подстрокой, совпавшей с группой, или, если используются \0 или $0, всем выражением.
Синтаксис
preg_filter(pattern, replacement, input, limit, count)
Значения параметров
Parameter | Description |
---|---|
pattern | Required. Contains a regular expression indicating what to search for |
replacement | Required. A string which will replace the matched patterns. It may contain backreferences |
input | Required. A string or array of strings in which the 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: | 5.3.0 |
❮ Справочник по регулярному выражению PHP