Funktsioon preg_match_all

Funktsioon preg_match_all teostab globaalse mustri otsingu stringis. Esimesse parameetrisse edastatakse regulaaravaldis, teise - otsitav string, kolmandasse - tulemuste salvestamise massiiv. Neljas valikuline parameeter määratleb tagastatava struktuuri tüübi ja viies valikuline parameeter - otsingu alguse nihke.

Süntaks

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

Lipud

Vaatame, milliseid väärtusi võib neljas parameeter võtta:

Parameeter	Kirjeldus
`PREG_PATTERN_ORDER`	Vaikimisi režiim. Tulemused grupeeritakse pokkide järgi - nullind massiivi element sisaldab nullinda pokki, esimene massiivi element sisaldab esimest pokki ja nii edasi.
`PREG_SET_ORDER`	Tulemused grupeeritakse vastete järgi - iga massiivi element sisaldab leitud pokkidest koosnevat massiivi.
`PREG_OFFSET_CAPTURE`	Iga vastet tagastatakse koos positsiooniga stringis. Iga tulemus esitatakse massiivina, kus nullind element sisaldab vastet ja esimene - selle nihet.
`PREG_UNMATCHED_AS_NULL`	Mittesobivad pokid tagastatakse väärtusena `null` selle asemel, et tagastada tühjad stringid.

Näide

Leiame kõik numbrid stringist:

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

Koodi täitmise tulemus:

['123', '456']

Näide

Leiame kõik tähed 'a' stringist:

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

Koodi täitmise tulemus:

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

Näide

Eraldame kõik ajatemplid stringist ja nende komponendid:

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

Koodi täitmise tulemus:

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

Näide

Ja nüüd kasutame lippu PREG_SET_ORDER grupeerimiseks vastete järgi:

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

Koodi täitmise tulemus:

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

Vaata ka

funktsiooni preg_match,
mis otsib esimest regulaaravaldisele vastet
funktsiooni preg_replace,
mis teostab otsingu ja asendamise regulaaravaldise järgi