Funkcia preg_match_all

Funkcia preg_match_all vykonáva globálne vyhľadávanie vzoru v reťazci. Do prvého parametra sa odovzdáva regulárny výraz, do druhého - reťazec pre vyhľadávanie, do tretieho - pole pre uloženie výsledkov. Štvrtý voliteľný parameter určuje typ vrátenej štruktúry, a piaty voliteľný parameter - posun začiatku vyhľadávania.

Syntax

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

Vlajky

Pozrime sa, aké hodnoty môže nadobúdať štvrtý parameter:

Parameter	Popis
`PREG_PATTERN_ORDER`	Režim predvolený. Výsledky sú zoskupené podľa zachytených skupín - nultý prvok poľa obsahuje nulté zachytené skupiny, prvý prvok poľa obsahuje prvé zachytené skupiny a tak ďalej.
`PREG_SET_ORDER`	Výsledky sú zoskupené podľa zhôd - každý prvok poľa obsahuje pole s nájdenými zachytenými skupinami.
`PREG_OFFSET_CAPTURE`	Pre každú zhodu sa vráti pozícia v reťazci. Každý výsledok predstavuje pole, kde nultý prvok obsahuje zhodu, a prvý - jej posun.
`PREG_UNMATCHED_AS_NULL`	Nezachytené skupiny sa vrátia ako `null` namiesto prázdnych reťazcov.

Príklad

Nájdeme všetky číslice v reťazci:

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

Výsledok vykonania kódu:

php['123', '456']

Príklad

Nájdeme všetky písmená 'a' v reťazci:

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

Výsledok vykonania kódu:

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

Príklad

Extrahujeme všetky časové značky z reťazca a ich 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ýsledok vykonania 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']
]

Príklad

A teraz použijeme vlajku PREG_SET_ORDER pre zoskupenie podľa zhôd:

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ýsledok vykonania 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'
]

Pozrite tiež

funkciu preg_match,
ktorá hľadá prvú zhodu s regulárnym výrazom
funkciu preg_replace,
ktorá vykonáva vyhľadávanie a nahradzovanie podľa regulárneho výrazu