Funkcja preg_match_all

Funkcja preg_match_all wykonuje globalne wyszukiwanie wzorca w ciągu. W pierwszym parametrze przekazywane jest wyrażenie regularne, w drugim - ciąg do przeszukania, w trzecim - tablica do zapisania wyników. Czwarty parametr opcjonalny określa strukturę zwracanych danych, a piąty parametr opcjonalny - przesunięcie rozpoczęcia wyszukiwania.

Składnia

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

Flagi

Przyjrzyjmy się, jakie wartości może przyjąć czwarty parametr:

Parametr	Opis
`PREG_PATTERN_ORDER`	Domyślny tryb. Wyniki grupowane są według grup przechwytujących - element zerowy tablicy zawiera grupy zerowe, pierwszy element tablicy zawiera grupy pierwsze i tak dalej.
`PREG_SET_ORDER`	Wyniki grupowane są według dopasowań - każdy element tablicy zawiera tablicę ze znalezionymi grupami przechwytującymi.
`PREG_OFFSET_CAPTURE`	Dla każdego dopasowania zwracana jest pozycja w ciągu. Każdy wynik reprezentuje tablicę, gdzie element zerowy zawiera dopasowanie, a pierwszy - jego przesunięcie.
`PREG_UNMATCHED_AS_NULL`	Niedopasowane grupy zwracane są jako `null` zamiast pustych ciągów.

Przykład

Znajdźmy wszystkie cyfry w ciągu:

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

Wynik wykonania kodu:

['123', '456']

Przykład

Znajdźmy wszystkie litery 'a' w ciągu:

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

Wynik wykonania kodu:

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

Przykład

Wyodrębnijmy wszystkie znaczniki czasu z ciągu i ich składniki:

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

Wynik wykonania kodu:

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

Przykład

A teraz użyjmy flagi PREG_SET_ORDER dla grupowania według dopasowań:

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

Wynik wykonania kodu:

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

Zobacz też

funkcję preg_match,
która wyszukuje pierwsze dopasowanie do wyrażenia regularnego
funkcję preg_replace,
która wykonuje wyszukiwanie i zamianę według wyrażenia regularnego