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

phppreg_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<?php
  $str = 'abc 123 def 456';
  preg_match_all('/\d+/', $str, $res);
  var_dump($res[0]);
?>

Wynik wykonania kodu:

php['123', '456']

Przykład

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

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

Wynik wykonania kodu:

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

Przykład

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

php<?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:

php[
  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<?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:

php[
  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