Funktio preg_match_all

Funktio preg_match_all suorittaa globaalin haun mallin mukaan merkkijonossa. Ensimmäiseen parametriin välitetään säännöllinen lauseke, toiseen - haettava merkkijono, kolmanteen - tulosten tallentamiseen tarkoitettu taulukko. Neljäs valinnainen parametri määrittää palautettavan rakenteen tyypin, ja viides valinnainen parametri - haun aloitusoffsetin.

Syntaksi

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

Liput

Katsotaan, mitä arvoja neljäs parametri voi saada:

Parametri	Kuvaus
`PREG_PATTERN_ORDER`	Oletustila. Tulokset ryhmitellään taskujen mukaan - nollas taulukon elementti sisältää nollannen taskun, ensimmäinen elementti sisältää ensimmäisen taskun ja niin edelleen.
`PREG_SET_ORDER`	Tulokset ryhmitellään osumien mukaan - jokainen taulukon elementti sisältää taulukon löydetyistä taskuista.
`PREG_OFFSET_CAPTURE`	Jokaisesta osumasta palautetaan sijainti merkkijonossa. Jokainen tulos on taulukko, jossa nollas elementti sisältää osuman ja ensimmäinen - sen offsetin.
`PREG_UNMATCHED_AS_NULL`	Osumattomat taskut palautetaan arvona `null` tyhjien merkkijonojen sijaan.

Esimerkki

Etsitään kaikki numerot merkkijonosta:

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

Koodin suorituksen tulos:

['123', '456']

Esimerkki

Etsitään kaikki kirjaimet 'a' merkkijonosta:

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

Koodin suorituksen tulos:

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

Esimerkki

Poimitaan kaikki aikaleimat merkkijonosta ja niiden komponentit:

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

Koodin suorituksen tulos:

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

Esimerkki

Ja nyt käytetään lippua PREG_SET_ORDER ryhmittelyyn osumien mukaan:

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

Koodin suorituksen tulos:

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

Katso myös

funktion preg_match,
joka etsii ensimmäisen säännöllisen lausekkeen osuman
funktion preg_replace,
joka suorittaa haun ja korvauksen säännöllisen lausekkeen mukaan