Funcția preg_filter

Funcția preg_filter efectuează căutare și înlocuire într-un șir sau matrice de șiruri folosind o expresie regulată. Spre deosebire de preg_replace, ea returnează doar acele elemente în care a fost găsită o potrivire. Primul parametru primește expresia regulată, al doilea - șirul de înlocuire, al treilea - șirul sau matricea de procesat. Al patrulea parametru opțional poate stabili numărul maxim de înlocuiri în fiecare element (implicit -1, ceea ce înseamnă "fără restricții"). Al cincilea parametru opțional specifică variabila în care va fi scris numărul de înlocuiri efectuate.

Sintaxă

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

Exemplu

Să înlocuim toate cifrele din șir cu simbolul 'X':

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

Rezultatul executării codului:

php'aXbXcX'

Exemplu

Să procesăm un șir de matrice, înlocuind cifrele cu '#':

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

Rezultatul executării codului:

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

Exemplu

Să demonstrăm diferența față de 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);
?>

Rezultatul executării codului:

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

Vedeți și

  • funcția preg_replace,
    care efectuează înlocuire cu expresie regulată
  • funcția preg_match,
    care verifică potrivirea cu o expresie regulată