Funkcija preg_filter

Funkcija preg_filter atlieka paiešką ir pakeitimą eilutėje arba eilučių masyve pagal reguliarųjį reiškinį. Skirtingai nei preg_replace, ji grąžina tik tuos elementus, kuriuose buvo rasta atitikmuo. Pirmuoju parametru priima reguliarųjį reiškinį, antruoju - pakeitimo eilutę, trečiuoju - apdorojimui skirtą eilutę arba masyvą. Ketvirtuoju pasirinktiniu parametru galima nustatyti maksimalų pakeitimų skaičių kiekviename elemente (pagal nutylėjimą -1, kas reiškia "be apribojimų"). Penktuoju pasirinktiniu parametru nurodomas kintamasis, į kurį bus įrašytas atliktų pakeitimų skaičius.

Sintaksė

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

Pavyzdys

Pakeisime visus skaitmenis eilutėje simboliu 'X':

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

Kodo vykdymo rezultatas:

php'aXbXcX'

Pavyzdys

Apdorosime eilučių masyvą, pakeisdami skaitmenis į '#':

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Pademonstruosime skirtumą nuo 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);
?>

Kodo vykdymo rezultatas:

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

Taip pat žiūrėkite

  • funkciją preg_replace,
    kuri atlieka pakeitimą pagal reguliarųjį reiškinį
  • funkciją preg_match,
    kuri tikrina atitikimą reguliarajam reiškiniai