preg_filter

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

preg_filter — Здійснює пошук та заміну за регулярним виразом

Опис

preg_filter(    string|array $pattern,    string|array $replacement,    string|array $subject,    int $limit = -1,    int &$count = null): string|array|null

Функцияpreg_filter() ідентична функції preg_replace() крім того, що повертає ті значення (можливо, перетворені), у яких знайдено збіг. Докладніше про роботу функції читайте у документації до preg_replace()

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

Параметри описані в документації для функції preg_replace()

Значення, що повертаються

Повертає масив (array), якщо аргумент subject має тип array або рядок (string) в іншому випадку.

Якщо збігів не знайдено або виникла помилка, повертається порожній масив (array), коли subject має тип array або null в іншому випадку.

Помилки

Якщо переданий шаблон регулярного виразу не компілюється в допустимий регулярний вираз, видається помилка рівня E_WARNING

Приклади

Приклад #1 Приклад для сравнения функцийpreg_filter()иpreg_replace()

Loading...

Результат виконання наведеного прикладу:

preg_filter возвращает
Array
(
    [0] => А:В:1
    [1] => Б:В:а
    [2] => А:2
    [3] => Б:б
    [4] => А:3
    [7] => А:4
)
preg_replace возвращает
Array
(
    [0] => А:В:1
    [1] => Б:В:а
    [2] => А:2
    [3] => Б:б
    [4] => А:3
    [5] => А
    [6] => Б
    [7] => А:4
)

Дивіться також

Шаблони PCRE
preg_quote() - Екранує символи у регулярних виразах
preg_replace() - Виконує пошук та заміну за регулярним виразом
preg_replace_callback() - Виконує пошук за регулярним виразом та заміною з використанням callback-функції
preg_grep() - Повертає масив входжень, які відповідають шаблону
preg_last_error() - Повертає код помилки виконання останнього регулярного вираження PCRE