Funkcija preg_match_all

Funkcija preg_match_all veic globālu parauga meklēšanu virknē. Pirmajā parametrā tiek padota regulārā izteiksme, otrajā - meklēšanas virkne, trešajā - masīvs rezultātu saglabāšanai. Ceturtais neobligātais parametrs nosaka atgriežamās struktūras veidu, bet piektais neobligātais parametrs - meklēšanas sākuma nobīdi.

Sintakse

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

Karogi

Apskatīsim, kādas vērtības var pieņemt ceturtais parametrs:

Parametrs	Apraksts
`PREG_PATTERN_ORDER`	Noklusējuma režīms. Rezultāti tiek grupēti pēc capture grupām - nulles masīva elements satur nulles capture grupas, pirmais masīva elements satur pirmās capture grupas un tā tālāk.
`PREG_SET_ORDER`	Rezultāti tiek grupēti pēc atbilstībām - katrs masīva elements satur masīvu ar atrastajām capture grupām.
`PREG_OFFSET_CAPTURE`	Katrai atbilstībai tiek atgriezta pozīcija virknē. Katrs rezultāts ir masīvs, kur nulles elements satur atbilstību, bet pirmais - tās nobīdi.
`PREG_UNMATCHED_AS_NULL`	Neatrastās capture grupas tiek atgrieztas kā `null` tukšu virkņu vietā.

Piemērs

Atradīsim visus ciparus virknē:

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

Koda izpildes rezultāts:

['123', '456']

Piemērs

Atradīsim visas burtus 'a' virknē:

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

Koda izpildes rezultāts:

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

Piemērs

Iegūstim visas laika zīmes no virknes un to komponentus:

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

Koda izpildes rezultāts:

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

Piemērs

Tagad izmantosim karogu PREG_SET_ORDER grupēšanai pēc atbilstībām:

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

Koda izpildes rezultāts:

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

Skatiet arī

funkciju preg_match,
kura meklē pirmo atbilstību regulārajai izteiksmei
funkciju preg_replace,
kura veic meklēšanu un aizvietošanu ar regulāro izteiksmi