Funkcija preg_match_all

Funkcija preg_match_all atlieka globalų šablono paiešką eilutėje. Į pirmą parametrą perduodama reguliarioji išraiška, į antrą - paieškos eilutė, į trečią - rezultatų saugojimo masyvas. Ketvirtas neprivalomas parametras nustato grąžinamos struktūros tipą, o penktas neprivalomas parametras - paieškos pradžios poslinkį.

Sintaksė

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

Vėliavos

Pažiūrėkime, kokias reikšmes gali priimti ketvirtas parametras:

Parametras	Aprašas
`PREG_PATTERN_ORDER`	Numatytasis režimas. Rezultatai grupuojami pagal "kišenes" - nulinis masyvo elementas talpina nulines kišenes, pirmas masyvo elementas talpina pirmąsias kišenes ir taip toliau.
`PREG_SET_ORDER`	Rezultatai grupuojami pagal atitikmenis - kiekvienas masyvo elementas talpina masyvą su rastomis kišenėmis.
`PREG_OFFSET_CAPTURE`	Kiekvienam atitikmeniui grąžinama pozicija eilutėje. Kiekvienas rezultatas yra masyvas, kur nulinis elementas talpina atitikmenį, o pirmasis - jo poslinkį.
`PREG_UNMATCHED_AS_NULL`	Neatitiktos kišenės grąžinamos kaip `null` vietoje tuščių eilučių.

Pavyzdys

Raskime visus skaitmenis eilutėje:

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

Kodo vykdymo rezultatas:

['123', '456']

Pavyzdys

Raskime visas raides 'a' eilutėje:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Išskirkime visus laiko žymas iš eilutės ir jų 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);
?>

Kodo vykdymo rezultatas:

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

Pavyzdys

O dabar panaudokime vėliavą PREG_SET_ORDER grupuojant pagal atitikmenis:

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

Kodo vykdymo rezultatas:

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

Taip pat žiūrėkite

funkciją preg_match,
kuri ieško pirmo atitikmens su reguliaria išraiška
funkciją preg_replace,
kuri atlieka paiešką ir pakeitimą pagal reguliariąją išraišką