Função preg_match_all

A função preg_match_all executa uma busca global por um padrão em uma string. No primeiro parâmetro é passada a expressão regular, no segundo - a string para busca, no terceiro - o array para salvar os resultados. O quarto parâmetro opcional define a estrutura retornada, e o quinto parâmetro opcional - o deslocamento do início da busca.

Sintaxe

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

Flags

Vamos ver quais valores o quarto parâmetro pode assumir:

Parâmetro	Descrição
`PREG_PATTERN_ORDER`	Modo padrão. Os resultados são agrupados por grupos - o elemento zero do array contém os grupos zero, o primeiro elemento do array contém os primeiros grupos e assim por diante.
`PREG_SET_ORDER`	Os resultados são agrupados por correspondências - cada elemento do array contém um array com os grupos encontrados.
`PREG_OFFSET_CAPTURE`	Para cada correspondência, a posição na string é retornada. Cada resultado é um array onde o elemento zero contém a correspondência, e o primeiro - seu deslocamento.
`PREG_UNMATCHED_AS_NULL`	Gros não correspondentes são retornados como `null` em vez de strings vazias.

Exemplo

Vamos encontrar todos os dígitos em uma string:

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

Resultado da execução do código:

['123', '456']

Exemplo

Vamos encontrar todas as letras 'a' em uma string:

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

Resultado da execução do código:

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

Exemplo

Vamos extrair todos os carimbos de tempo da string e seus componentes:

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

Resultado da execução do código:

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

Exemplo

E agora vamos usar a flag PREG_SET_ORDER para agrupar por correspondências:

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

Resultado da execução do código:

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

Veja também

a função preg_match,
que busca a primeira correspondência com uma expressão regular
a função preg_replace,
que executa busca e substituição por expressão regular