preg_match_all

Parámetros

pattern

La máscara a buscar, en forma de cadena.

subject

La cadena de entrada.

matches

Array que contiene todos los resultados, en un array multidimensional ordenado según el parámetro flags.

flags

Si no se proporciona ningún flag de orden, se asume PREG_PATTERN_ORDER.

Puede ser una combinación de los siguientes valores (señalando que es incoherente usar PREG_PATTERN_ORDER con PREG_SET_ORDER ) :

PREG_PATTERN_ORDER

El orden es tal que $matches[0] es un array que contiene los resultados que satisfacen la máscara completa, $matches[1] es un array que contiene los resultados que satisfacen la primera subexpresión capturante, etc.

<?php
preg_match_all("|<[^>]+>(.*)</[^>]+>|U",
"<b>ejemplo : </b><div align=left>esto es una prueba</div>",
$out, PREG_PATTERN_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>

El ejemplo anterior mostrará:

<b>ejemplo : </b>, <div align=left>esto es una prueba</div>
ejemplo : , esto es una prueba

Así, $out[0] es un array que contiene los resultados que satisfacen la máscara completa, y $out[1] es un array que contiene las etiquetas entre los caracteres de mayor y menor que.

Si la máscara contiene submáscaras nombradas, $matches contendrá además entradas que tendrán como claves los nombres de las submáscaras.

Si la máscara contiene submáscaras nombradas duplicadas, solo la submáscara más a la derecha será registrada en $matches[NAME].

<?php
preg_match_all(
'/(?J)(?<match>foo)|(?<match>bar)/',
'foo bar',
$matches,
PREG_PATTERN_ORDER
);
print_r($matches['match']);
?>

El ejemplo anterior mostrará:

Array
(
    [0] =>
    [1] => bar
)

PREG_SET_ORDER

Los resultados se ordenan de tal forma que $matches[0] contiene la primera serie de resultados, $matches[1] contiene la segunda, etc.

<?php
preg_match_all("|<[^>]+>(.*)</[^>]+>|U",
"<b>ejemplo : </b><div align=\"left\">esto es una prueba</div>",
$out, PREG_SET_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>

El ejemplo anterior mostrará:

<b>ejemplo : </b>, ejemplo :
<div align="left">esto es una prueba</div>, esto es una prueba

PREG_OFFSET_CAPTURE

Si este flag es pasado, todas las subcadenas que satisfacen la máscara también serán identificadas por su offset (en bytes). Tenga en cuenta que esto modifica el valor de matches en un array de arrays donde cada elemento es un array que contiene la subcadena satisfecha en el índice 0 y el índice de esta en la cadena subject en el índice 1.

<?php
preg_match_all('/(foo)(bar)(baz)/', 'foobarbaz', $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>

El ejemplo anterior mostrará:

Array
(
    [0] => Array
        (
            [0] => Array
                (
                    [0] => foobarbaz
                    [1] => 0
                )

        )

    [1] => Array
        (
            [0] => Array
                (
                    [0] => foo
                    [1] => 0
                )

        )

    [2] => Array
        (
            [0] => Array
                (
                    [0] => bar
                    [1] => 3
                )

        )

    [3] => Array
        (
            [0] => Array
                (
                    [0] => baz
                    [1] => 6
                )

        )

)

PREG_UNMATCHED_AS_NULL

Si este flag es pasado, las subexpresiones no satisfechas son reportadas como null; de lo contrario, son reportadas como una string vacía.

offset

Normalmente, la búsqueda comienza al inicio de la cadena subject. El parámetro opcional offset puede ser usado para especificar una posición para el inicio de la búsqueda (en bytes).

Nota:

Usar el parámetro offset no equivale a pasar substr($subject, $offset) a preg_match_all() en lugar de la cadena subject, ya que pattern puede contener aserciones como ^, $ o (?<=x). Consulte la documentación sobre la función preg_match() para ejemplos.