Функция preg_match_all

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

Синтаксис

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

Флаги

Давайте посмотрим, какие значения может принимать четвертый параметр:

Параметр	Описание
`PREG_PATTERN_ORDER`	Режим по умолчанию. Результаты группируются по карманам - нулевой элемент массива содержит нулевые карманы, первый элемент массива содержит первые карманы и так далее.
`PREG_SET_ORDER`	Результаты группируются по совпадениям - каждый элемент массива содержит массив с найденными карманами.
`PREG_OFFSET_CAPTURE`	Для каждого совпадения возвращается позиция в строке. Каждый результат представляет собой массив, где нулевой элемент содержит совпадение, а первый - его смещение.
`PREG_UNMATCHED_AS_NULL`	Несовпавшие карманы возвращаются как `null` вместо пустых строк.

Пример

Найдем все цифры в строке:

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

Результат выполнения кода:

['123', '456']

Пример

Найдем все буквы 'a' в строке:

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

Результат выполнения кода:

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

Пример

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

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

Результат выполнения кода:

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

Результат выполнения кода:

[
	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,
которая выполняет поиск и замену по регулярному выражению