PHP preg_match() Fonction

❮ Référence PHP RegExp

Exemple

Utilisez une expression régulière pour effectuer une recherche insensible à la casse de "formation-ti.org" dans une chaîne :

<?php
$str = "Visitez formation-ti.org";
$pattern = "/formation-ti.org/i";
echo preg_match($pattern, $str);
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction preg_match() retourne si une correspondance a été trouvée dans une chaîne.

Syntaxe

preg_match( pattern, input, matches, flags, offset )

Valeurs des Paramètres

Paramètre Description
pattern Requis. Contient une expression régulière indiquant ce qu'il faut rechercher.
input Requis. La chaîne dans laquelle la recherche sera effectuée.
matches Optionnel. La variable utilisée dans ce paramètre sera remplie avec un tableau contenant toutes les correspondances trouvées.
flags Optionnel. Un ensemble d'options qui modifient la structure du tableau des correspondances :
  • PREG_OFFSET_CAPTURE - Lorsque cette option est activée, chaque correspondance, au lieu d'être une chaîne, sera un tableau où le premier élément est une sous-chaîne contenant la correspondance et le deuxième élément est la position du premier caractère de la sous-chaîne dans l'entrée.
  • PREG_UNMATCHED_AS_NULL - Lorsque cette option est activée, les sous-modèles non appariés seront retournés comme NULL au lieu d'une chaîne vide.
offset Optionnel. Par défaut à 0. Indique jusqu'où dans la chaîne commencer la recherche. La fonction preg_match() ne trouvera pas les correspondances qui se produisent avant la position donnée dans ce paramètre.

Détails Techniques

Valeur de Retour : Retourne 1 si une correspondance a été trouvée, 0 si aucune correspondance n'a été trouvée et false si une erreur s'est produite.
Version PHP : 4+
Journal des Modifications : PHP 7.2 - Ajout du drapeau PREG_UNMATCHED_AS_NULL

PHP 5.3.6 - La fonction retourne false lorsque l'offset est plus long que la longueur de l'entrée

PHP 5.2.2 - Les sous-modèles nommés peuvent utiliser la syntaxe (?'name') et (? <name>) en plus de la précédente (?P<name>)

Plus d'Exemples

Exemple

Utilisez PREG_OFFSET_CAPTURE pour trouver la position dans la chaîne d'entrée où les correspondances ont été trouvées :

<?php
$str = "Bienvenue sur formation-ti.org";
$pattern = "/formation-ti.org/i";
preg_match($pattern, $str, $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>
Essayez-le vous-même »
❮ Référence PHP RegExp