Функцыя preg_filter

Функцыя preg_filter выконвае пошук і замену ў радку або масіве радкоў па рэгулярным выразе. У адрозненне ад preg_replace, яна вяртае толькі тыя элементы, у якіх было знойдзена супадзенне. Першым параметрам прымае рэгулярны выраз, другім - радок замены, трэцім - радок або масіў для апрацоўкі. У чацвёртым неабавязковым параметры можна задаць максімальную колькасць замен у кожным элеменце (па змаўчанні -1, што азначае "без абмежаванняў"). У пятым неабавязковым параметры паказваецца зменная, у якую будзе запісана колькасць выкананых замен.

Сінтаксіс

phppreg_filter(pattern, replacement, subject, [limit = -1], [count]);

Прыклад

Замянім усе лічбы ў радку на сімвал 'X':

php<?php
  $res = preg_filter('/\d/', 'X', 'a1b2c3');
  var_dump($res);
?>

Вынік выканання кода:

php'aXbXcX'

Прыклад

Апрацуем масіў радкоў, замяніўшы лічбы на '#':

php<?php
  $res = preg_filter('/\d/', '#', ['a1', 'b2', 'c', 'd4']);
  var_dump($res);
?>

Вынік выканання кода:

php['a#', 'b#', 'd#']

Прыклад

Прадэманструем адрозненне ад preg_replace:

php<?php
  $input = ['a1', 'b2', 'c', 'd4'];
  $res_filter = preg_filter('/\d/', '#', $input);
  $res_replace = preg_replace('/\d/', '#', $input);
  echo "Filter result: ";
  var_dump($res_filter);
  echo "Replace result: ";
  var_dump($res_replace);
?>

Вынік выканання кода:

phpFilter result: ['a#', 'b#', 'd#']
Replace result: ['a#', 'b#', 'c', 'd#']

Глядзіце таксама