Funkcija preg_filter

Funkcija preg_filter veic meklēšanu un aizstāšanu virknē vai virkņu masīvā ar regulāro izteiksmi. Atšķirībā no preg_replace, tā atgriež tikai tos elementus, kuros tika atrasts atbilstība. Pirmā parametra pieņem regulāro izteiksmi, otrais - aizstāšanas virkni, trešais - virkni vai masīvu apstrādei. Ceturtajā neobligātajā parametrā var iestatīt maksimālo aizstāšanu skaitu katrā elementā (pēc noklusējuma -1, kas nozīmē "bez ierobežojumiem"). Piektajā neobligātajā parametrā norāda mainīgo, kurā tiks ierakstīts veikto aizstāšanu skaits.

Sintakse

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

Piemērs

Aizstāsim visus ciparus virknē ar simbolu 'X':

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

Koda izpildes rezultāts:

php'aXbXcX'

Piemērs

Apstrādāsim virkņu masīvu, aizstājot ciparus ar '#':

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

Koda izpildes rezultāts:

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

Piemērs

Parādīsim atšķirību no 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);
?>

Koda izpildes rezultāts:

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

Skatiet arī

  • funkciju preg_replace,
    kas veic aizstāšanu ar regulāro izteiksmi
  • funkciju preg_match,
    kas pārbauda atbilstību regulārajai izteiksmei