Функцыя 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,
    якая выконвае пошук і замену па рэгулярным выражу