Funkcija preg_match_all

Funkcija preg_match_all izvede globalno iskanje vzorca v nizu. V prvi parameter se poda regularni izraz, v drugi - niz za iskanje, v tretji - polje za shranjevanje rezultatov. Četrti neobvezni parameter določa strukturo vrnjenega rezultata, peti neobvezni parameter pa odmik začetka iskanja.

Sintaksa

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

Zastavice

Poglejmo, katere vrednosti lahko sprejme četrti parameter:

Parameter	Opis
`PREG_PATTERN_ORDER`	Privzet način. Rezultati so združeni po skupinah - ničti element polja vsebuje ničte skupine, prvi element polja vsebuje prve skupine in tako naprej.
`PREG_SET_ORDER`	Rezultati so združeni po ujemanjih - vsak element polja vsebuje polje z najdenimi skupinami.
`PREG_OFFSET_CAPTURE`	Za vsako ujemanje se vrne položaj v nizu. Vsak rezultat je polje, kjer ničti element vsebuje ujemanje, prvi pa njegov odmik.
`PREG_UNMATCHED_AS_NULL`	Neujete skupine se vrnejo kot `null` namesto praznih nizov.

Primer

Poiščimo vse števke v nizu:

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

Rezultat izvajanja kode:

['123', '456']

Primer

Poiščimo vse črke 'a' v nizu:

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

Rezultat izvajanja kode:

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

Primer

Izvlečimo vse časovne žige iz niza in njihove komponente:

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

Rezultat izvajanja kode:

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

Primer

Zdaj pa uporabimo zastavico PREG_SET_ORDER za združevanje po ujemanjih:

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

Rezultat izvajanja kode:

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

Glejte tudi

funkcijo preg_match,
ki poišče prvo ujemanje z regularnim izrazom
funkcijo preg_replace,
ki izvede iskanje in zamenjavo po regularnem izrazu