Fonction preg_match_all

La fonction preg_match_all effectue une recherche globale de motif dans une chaîne. Le premier paramètre reçoit l'expression régulière, le second - la chaîne à rechercher, le troisième - le tableau pour sauvegarder les résultats. Le quatrième paramètre optionnel définit la structure de retour, et le cinquième paramètre optionnel - le décalage de début de recherche.

Syntaxe

preg_match_all(pattern, subject, matches, [flags], [offset]);

Drapeaux

Voyons quelles valeurs peut prendre le quatrième paramètre :

Paramètre	Description
`PREG_PATTERN_ORDER`	Mode par défaut. Les résultats sont groupés par groupes de capture - l'élément zéro du tableau contient les groupes de capture zéro, le premier élément du tableau contient les premiers groupes de capture et ainsi de suite.
`PREG_SET_ORDER`	Les résultats sont groupés par correspondances - chaque élément du tableau contient un tableau avec les groupes de capture trouvés.
`PREG_OFFSET_CAPTURE`	Pour chaque correspondance, la position dans la chaîne est retournée. Chaque résultat représente un tableau où l'élément zéro contient la correspondance, et le premier - son décalage.
`PREG_UNMATCHED_AS_NULL`	Les groupes de capture non correspondants sont retournés comme `null` au lieu de chaînes vides.

Exemple

Trouvons tous les chiffres dans une chaîne :

<?php
	$str = 'abc 123 def 456';
	preg_match_all('/\d+/', $str, $res);
	var_dump($res[0]);
?>

Résultat de l'exécution du code :

['123', '456']

Exemple

Trouvons toutes les lettres 'a' dans une chaîne :

<?php
	$str = 'banana';
	preg_match_all('/a/', $str, $res);
	var_dump($res[0]);
?>

Résultat de l'exécution du code :

['a', 'a', 'a']

Exemple

Extrayons toutes les horodatages d'une chaîne et leurs composants :

<?php
	$time = '12:01:02 13:03:04 14:05:06';
	preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res);
	var_dump($res);
?>

Résultat de l'exécution du code :

[
	0 => ['12:01:02', '13:03:04', '14:05:06'],
	1 => ['12', '13', '14'],
	2 => ['01', '03', '05'],
	3 => ['02', '04', '06']
]

Exemple

Et maintenant utilisons le drapeau PREG_SET_ORDER pour le groupement par correspondances :

<?php
	$time = '12:01:02 13:03:04 14:05:06';
	preg_match_all('#(\d\d):(\d\d):(\d\d)#', $time, $res, PREG_SET_ORDER);
	var_dump($res);
?>

Résultat de l'exécution du code :

[
	0 => '12:01:02',
	1 => '12',
	2 => '01',
	3 => '02'
],
[
	0 => '13:03:04',
	1 => '13',
	2 => '03',
	3 => '04'
],
[
	0 => '14:05:06',
	1 => '14',
	2 => '05',
	3 => '06'
]

Voir aussi

la fonction preg_match,
qui recherche la première correspondance avec une expression régulière
la fonction preg_replace,
qui effectue une recherche et remplacement par expression régulière