Функция preg_match_all

Функцията preg_match_all извършва глобално търсене на шаблон в низ. В първия параметър се подава регулярен израз, във втория - низ за търсене, в третия - масив за запазване на резултатите. Четвъртият незадължителен параметър определя типа на върнатата структура, а петият незадължителен параметър - отместването на началото на търсенето.

Синтаксис

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

Флагове

Нека видим какви стойности може да приема четвъртият параметър:

Параметър Описание
PREG_PATTERN_ORDER Режим по подразбиране. Резултатите се групират по групи - нулевият елемент от масива съдържа нулевите групи, първият елемент от масива съдържа първите групи и така нататък.
PREG_SET_ORDER Резултатите се групират по съвпадения - всеки елемент от масива съдържа масив с намерените групи.
PREG_OFFSET_CAPTURE За всяко съвпадение се връща позицията в низа. Всеки резултат представлява масив, където нулевият елемент съдържа съвпадението, а първият - неговото отместване.
PREG_UNMATCHED_AS_NULL Несъвпадналите групи се връщат като null вместо празни низове.

Пример

Нека намерим всички цифри в низ:

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

Резултат от изпълнението на кода:

php['123', '456']

Пример

Нека намерим всички букви 'a' в низ:

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

Резултат от изпълнението на кода:

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

Пример

Нека извлечем всички времеви маркери от низ и техните компоненти:

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

Резултат от изпълнението на кода:

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

Пример

А сега нека използваме флага PREG_SET_ORDER за групиране по съвпадения:

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

Резултат от изпълнението на кода:

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

Вижте също

  • функцията preg_match,
    която търси първото съвпадение с регулярен израз
  • функцията preg_replace,
    която изпълнява търсене и замяна по регулярен израз