Functie preg_match_all

De functie preg_match_all voert een globale zoekopdracht uit naar een patroon in een string. Aan de eerste parameter wordt de reguliere expressie doorgegeven, aan de tweede - de te doorzoeken string, aan de derde - de array voor het opslaan van resultaten. De vierde optionele parameter bepaalt de structuur van de geretourneerde resultaten, en de vijfde optionele parameter - de offset van het begin van de zoekopdracht.

Syntaxis

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

Flags

Laten we eens kijken welke waarden de vierde parameter kan aannemen:

Parameter	Beschrijving
`PREG_PATTERN_ORDER`	Standaard modus. Resultaten worden gegroepeerd op capture groups - het nulde element van de array bevat de nulde capture groups, het eerste element van de array bevat de eerste capture groups enzovoort.
`PREG_SET_ORDER`	Resultaten worden gegroepeerd op overeenkomsten - elk element van de array bevat een array met de gevonden capture groups.
`PREG_OFFSET_CAPTURE`	Voor elke overeenkomst wordt de positie in de string geretourneerd. Elk resultaat is een array, waarbij het nulde element de overeenkomst bevat, en het eerste - de offset ervan.
`PREG_UNMATCHED_AS_NULL`	Niet-overeenkomende capture groups worden geretourneerd als `null` in plaats van lege strings.

Voorbeeld

Laten we alle cijfers in een string vinden:

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

Resultaat van de code-uitvoering:

['123', '456']

Voorbeeld

Laten we alle letters 'a' in een string vinden:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Laten we alle tijdstempels uit een string halen en hun componenten:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Laten we nu de flag PREG_SET_ORDER gebruiken voor groepering op overeenkomsten:

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

Resultaat van de code-uitvoering:

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

Zie ook

de functie preg_match,
die de eerste overeenkomst met een reguliere expressie zoekt
de functie preg_replace,
die zoeken en vervangen door een reguliere expressie uitvoert