Функция preg_match_all

La función preg_match_all realiza una búsqueda global de un patrón en una cadena. Al primer parámetro se le pasa la expresión regular, al segundo - la cadena para buscar, al tercero - el array para guardar los resultados. El cuarto parámetro opcional define la estructura de retorno, y el quinto parámetro opcional - el desplazamiento de inicio de la búsqueda.

Sintaxis

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

Banderas (Flags)

Veamos qué valores puede tomar el cuarto parámetro:

Parámetro	Descripción
`PREG_PATTERN_ORDER`	Modo por defecto. Los resultados se agrupan por capturas - el elemento cero del array contiene las capturas cero, el primer elemento del array contiene las primeras capturas y así sucesivamente.
`PREG_SET_ORDER`	Los resultados se agrupan por coincidencias - cada elemento del array contiene un array con las capturas encontradas.
`PREG_OFFSET_CAPTURE`	Para cada coincidencia se devuelve la posición en la cadena. Cada resultado es un array donde el elemento cero contiene la coincidencia, y el primero - su desplazamiento.
`PREG_UNMATCHED_AS_NULL`	Las capturas no coincidentes se devuelven como `null` en lugar de cadenas vacías.

Ejemplo

Encontremos todos los dígitos en una cadena:

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

Resultado de ejecutar el código:

['123', '456']

Ejemplo

Encontremos todas las letras 'a' en una cadena:

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

Resultado de ejecutar el código:

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

Ejemplo

Extraigamos todas las marcas de tiempo de una cadena y sus 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 de ejecutar el código:

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

Ejemplo

Y ahora usemos la bandera PREG_SET_ORDER para agrupar por coincidencias:

<?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 de ejecutar el 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'
]

Ver también

la función preg_match,
que busca la primera coincidencia con una expresión regular
la función preg_replace,
que realiza búsqueda y reemplazo mediante una expresión regular