Funcția preg_match_all

Funcția preg_match_all execută o căutare globală a modelului într-un șir. În primul parametru este transmisă expresia regulată, în al doilea - șirul pentru căutare, în al treilea - matricea pentru salvarea rezultatelor. Al patrulea parametru opțional determină structura returnată, iar al cincilea parametru opțional - decalajul de început al căutării.

Sintaxă

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

Steaguri (Flags)

Să vedem ce valori poate lua al patrulea parametru:

Parametru	Descriere
`PREG_PATTERN_ORDER`	Modul implicit. Rezultatele sunt grupate după "buzunare" (capturi) - elementul zero al matricei conține buzunarele zero, primul element al matricei conține primele buzunare și așa mai departe.
`PREG_SET_ORDER`	Rezultatele sunt grupate după potriviri - fiecare element al matricei conține un matrice cu buzunarele găsite.
`PREG_OFFSET_CAPTURE`	Pentru fiecare potrivire este returnată poziția în șir. Fiecare rezultat reprezintă un matrice în care elementul zero conține potrivirea, iar primul - decalajul acesteia.
`PREG_UNMATCHED_AS_NULL`	Buzunarele care nu s-au potrivit sunt returnate ca `null` în loc de șiruri goale.

Exemplu

Să găsim toate cifrele dintr-un șir:

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

Rezultatul executării codului:

['123', '456']

Exemplu

Să găsim toate literele 'a' dintr-un șir:

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

Rezultatul executării codului:

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

Exemplu

Să extragem toate marcajele temporale din șir și componentele lor:

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

Rezultatul executării codului:

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

Exemplu

Și acum să folosim steagul PREG_SET_ORDER pentru grupare după potriviri:

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

Rezultatul executării codului:

[
	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'
]

Vezi și

funcția preg_match,
care caută prima potrivire cu expresia regulată
funcția preg_replace,
care execută căutare și înlocuire după expresie regulată