Funksjonen preg_match_all

Funksjonen preg_match_all utfører et globalt søk etter et mønster i en streng. Til den første parameteren sendes det regulære uttrykket, til den andre - strengen for søk, til den tredje - matrisen for lagring av resultater. Den fjerde valgfrie parameteren bestemmer strukturen som returneres, og den femte valgfrie parameteren - forskyvningen for søkestart.

Syntaks

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

Flagg

La oss se hvilke verdier den fjerde parameteren kan ta:

Parameter Beskrivelse
PREG_PATTERN_ORDER Standard modus. Resultatene grupperes etter grupper - nullelementet i matrisen inneholder nullte grupper, første element i matrisen inneholder første grupper og så videre.
PREG_SET_ORDER Resultatene grupperes etter treff - hvert element i matrisen inneholder en matrise med de funnet gruppene.
PREG_OFFSET_CAPTURE For hvert treff returneres posisjonen i strengen. Hvert resultat representerer en matrise, der nullelementet inneholder treffet, og den første - dens forskyvning.
PREG_UNMATCHED_AS_NULL Ikke-trufne grupper returneres som null i stedet for tomme strenger.

Eksempel

La oss finne alle sifre i strengen:

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

Resultat av kjøring av koden:

php['123', '456']

Eksempel

La oss finne alle bokstavene 'a' i strengen:

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

Resultat av kjøring av koden:

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

Eksempel

La oss trekke ut alle tidsstempler fra strengen og deres komponenter:

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

Resultat av kjøring av koden:

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

Eksempel

Og la oss nå bruke flagget PREG_SET_ORDER for gruppering etter treff:

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

Resultat av kjøring av koden:

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

Se også

  • funksjonen preg_match,
    som søker etter første treff med regulært uttrykk
  • funksjonen preg_replace,
    som utfører søk og erstatning med regulært uttrykk