Liste de paramètres

pattern

Le masque à chercher, sous la forme d'une chaîne de caractères.

subject

La chaîne d'entrée.

matches

Si matches est fourni, il sera rempli par les résultats de la recherche. $matches[0] contiendra le texte qui satisfait le masque complet, $matches[1] contiendra le texte qui satisfait la première parenthèse capturante, etc.

flags

Le paramètre flags peut prendre l'une des valeurs suivantes :

PREG_OFFSET_CAPTURE

Si cette option est activée, toutes les sous-chaînes qui satisfont le masque seront aussi identifiées par leur offset. Notez que cela modifie le format de la valeur retournée , puisque chaque élément de réponse devient un tableau contenant la sous-chaîne résultat, à l'index 0 dans la chaîne subject constant 1.

offset

Normalement, la recherche commence au début de la chaîne subject . Le paramètre optionnel offset peut être utilisé pour spécifier une position pour le début de la recherche.

Note: Utiliser le paramètre offset ne revient pas à passer substr($subject, $offset) à preg_match_all() à la place de la chaîne subject , car pattern peut contenir des assertions comme ^, $ ou (?<=x). Comparez :

1. <?php
2. $subject = "abcdef";  
3. $pattern = '/^def/';  
4. preg_match($pattern, $subject, $matches, PREG_OFFSET_CAPTURE, 3);  
5. print_r($matches);  
6. ?> 

L'exemple ci-dessus va afficher :

Array ( )

avec cet exemple :

1. <?php
2. $subject = "abcdef";  
3. $pattern = '/^def/';  
4. preg_match($pattern, substr($subject,3), $matches, PREG_OFFSET_CAPTURE);  
5. print_r($matches);  
6. ?> 

produira :

Array ( [0] => Array ( [0] => def [1] => 0 ) )