PHP preg_filter() Fonction

❮ Référence PHP RegExp

Exemple

Enveloppez les nombres entre parenthèses dans une liste de chaînes :

<?php
$input = [
"Il est 5 heures",
"40 jours",
"Pas de nombres ici",
"Dans l'année 2000"
];

$result = preg_filter('/[0-9]+/', '($0)', $input);
print_r($result);
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction preg_filter() retourne une chaîne ou un tableau de chaînes dans lesquelles les correspondances du motif ont été remplacées par la chaîne de remplacement.

Si l'entrée est un tableau, cette fonction retourne un tableau. Si l'entrée est une chaîne, alors cette fonction retourne une chaîne.

Cette fonction est similaire à preg_replace() , avec une différence : lorsqu'aucune correspondance pour le motif n'est trouvée dans une chaîne d'entrée, celle-ci ne sera pas utilisée dans la valeur de retour. Dans ce cas, si l'entrée est une chaîne au lieu d'un tableau, la fonction retourne null .

Les chaînes de remplacement peuvent contenir des références inverses sous la forme \n ou $n, où n est l'index d'un groupe dans le motif. Dans la chaîne retournée, les instances de \n et $n seront remplacées par la sous-chaîne qui a été correspondue par le groupe ou, si \0 ou $0 sont utilisés, par l'expression entière.


Syntaxe

preg_filter( motif, remplacement, entrée, limite, compte )

Valeurs des Paramètres

Paramètre Description
motif Requis. Contient une expression régulière indiquant ce qu'il faut rechercher.
remplacement Requis. Une chaîne qui remplacera les motifs correspondants. Elle peut contenir des références inverses.
entrée Requis. Une chaîne ou un tableau de chaînes dans lesquelles les remplacements sont effectués.
limite Optionnel. Par défaut à -1, ce qui signifie illimité. Définit une limite au nombre de remplacements pouvant être effectués dans chaque chaîne.
compte Optionnel. Après l'exécution de la fonction, cette variable contiendra un nombre indiquant combien de remplacements ont été effectués.

Détails Techniques

Valeur de Retour : Retourne un tableau de chaînes remplacées si l'entrée était un tableau, une chaîne avec des remplacements effectués si l'entrée était une chaîne, ou null si l'entrée était une chaîne et aucune correspondance n'a été trouvée.
Version PHP : 5.3.0

❮ Référence PHP RegExp