Funkce preg_match_all

Funkce preg_match_all provádí globální vyhledávání vzoru v řetězci. Do prvního parametru se předává regulární výraz, do druhého - řetězec pro vyhledávání, do třetího - pole pro uložení výsledků. Čtvrtý volitelný parametr určuje typ vrácené struktury a pátý volitelný parametr - offset začátku vyhledávání.

Syntaxe

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

Příznaky

Podívejme se, jaké hodnoty může čtvrtý parametr nabývat:

Parametr Popis
PREG_PATTERN_ORDER Režim výchozího nastavení. Výsledky jsou seskupeny podle zachytávacích skupin - nultý prvek pole obsahuje nulté zachytávací skupiny, první prvek pole obsahuje první zachytávací skupiny a tak dále.
PREG_SET_ORDER Výsledky jsou seskupeny podle shod - každý prvek pole obsahuje pole s nalezenými zachytávacími skupinami.
PREG_OFFSET_CAPTURE Pro každou shodu je vrácena pozice v řetězci. Každý výsledek představuje pole, kde nultý prvek obsahuje shodu a první - její offset.
PREG_UNMATCHED_AS_NULL Neshodné zachytávací skupiny jsou vráceny jako null místo prázdných řetězců.

Příklad

Najdeme všechny číslice v řetězci:

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

Výsledek provedení kódu:

php['123', '456']

Příklad

Najdeme všechna písmena 'a' v řetězci:

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

Výsledek provedení kódu:

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

Příklad

Extrahujeme všechny časové značky z řetězce a jejich komponenty:

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

Výsledek provedení kódu:

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

Příklad

A nyní použijeme příznak PREG_SET_ORDER pro seskupení podle shod:

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

Výsledek provedení kódu:

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

Viz také

  • funkci preg_match,
    která hledá první shodu s regulárním výrazem
  • funkci preg_replace,
    která provádí vyhledávání a nahrazování podle regulárního výrazu