Functie preg_filter

De functie preg_filter voert zoeken en vervangen uit in een tekenreeks of een array van tekenreeksen met behulp van een reguliere expressie. In tegenstelling tot preg_replace, retourneert het alleen die elementen waarin een overeenkomst is gevonden. De eerste parameter accepteert de reguliere expressie, de tweede - de vervangende tekenreeks, de derde - de tekenreeks of array die moet worden verwerkt. In de vierde optionele parameter kan de maximale hoeveelheid vervangingen per element worden ingesteld (standaard -1, wat "geen limiet" betekent). In de vijfde optionele parameter wordt een variabele opgegeven waarin het aantal uitgevoerde vervangingen wordt geschreven.

Syntaxis

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

Voorbeeld

Laten we alle cijfers in de tekenreeks vervangen door het symbool 'X':

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

Resultaat van de code-uitvoering:

php'aXbXcX'

Voorbeeld

Laten we een array van tekenreeksen verwerken door cijfers te vervangen door '#':

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Laten we het verschil met preg_replace demonstreren:

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);
?>

Resultaat van de code-uitvoering:

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

Zie ook

  • de functie preg_replace,
    die vervanging uitvoert met een reguliere expressie
  • de functie preg_match,
    die controleert op een overeenkomst met een reguliere expressie