Funktion preg_match_all

Die Funktion preg_match_all führt eine globale Suche nach einem Muster in einem String durch. An den ersten Parameter wird der reguläre Ausdruck übergeben, an den zweiten - der String für die Suche, an den dritten - das Array zur Speicherung der Ergebnisse. Der vierte optionale Parameter bestimmt die Struktur der zurückgegebenen Daten, und der fünfte optionale Parameter - den Versatz des Suchbeginns.

Syntax

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

Flags

Lassen Sie uns sehen, welche Werte der vierte Parameter annehmen kann:

Parameter	Beschreibung
`PREG_PATTERN_ORDER`	Standardmodus. Die Ergebnisse werden nach Capturing Groups gruppiert - das nullte Element des Arrays enthält die nullten Groups, das erste Element des Arrays enthält die ersten Groups und so weiter.
`PREG_SET_ORDER`	Die Ergebnisse werden nach Übereinstimmungen gruppiert - jedes Element des Arrays enthält ein Array mit den gefundenen Capturing Groups.
`PREG_OFFSET_CAPTURE`	Für jede Übereinstimmung wird die Position im String zurückgegeben. Jedes Ergebnis ist ein Array, bei dem das nullte Element die Übereinstimmung enthält und das erste - deren Versatz.
`PREG_UNMATCHED_AS_NULL`	Nicht übereinstimmende Capturing Groups werden als `null` zurückgegeben, anstelle von leeren Strings.

Beispiel

Lassen Sie uns alle Zahlen in einem String finden:

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

Ergebnis der Codeausführung:

['123', '456']

Beispiel

Lassen Sie uns alle Buchstaben 'a' in einem String finden:

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

Ergebnis der Codeausführung:

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

Beispiel

Extrahieren wir alle Zeitstempel aus einem String und deren Komponenten:

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

Ergebnis der Codeausführung:

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

Beispiel

Und jetzt verwenden wir das Flag PREG_SET_ORDER für die Gruppierung nach Übereinstimmungen:

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

Ergebnis der Codeausführung:

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

Siehe auch

die Funktion preg_match,
die die erste Übereinstimmung mit einem regulären Ausdruck sucht
die Funktion preg_replace,
die eine Suche und Ersetzung mittels regulärem Ausdruck durchführt