Función PHP preg_match_all()

Expresiones regulares de PHP (PCRE)

La función preg_match_all se utiliza para realizar una coincidencia de expresión regular global.

Sintaxis

int preg_match_all ( string $pattern , string $subject [, array &$matches [, int $flags = PREG_PATTERN_ORDER [, int $offset = 0 ]]] )

Busca todas las coincidencias en subject que coincidan con la expresión regular dada por pattern y las muestra en matches en el orden especificado por flag.

Después de encontrar la primera coincidencia, la búsqueda posterior continúa desde la posición de la última coincidencia.

Descripción de parámetros:

  • $pattern: El patrón a buscar, en forma de cadena.

  • $subject: Cadena de entrada.

  • $matches: Matriz multidimensional, como parámetro de salida devuelve todos los resultados de coincidencias; el orden de la matriz se especifica mediante flags.

  • $flags: Se pueden usar con las siguientes banderas (nota: no se pueden usar PREG_PATTERN_ORDER y PREG_SET_ORDER al mismo tiempo).

    1. PREG_PATTERN_ORDER: los resultados se ordenan en $matches

    2. PREG_SET_ORDER: los resultados se ordenan como $matches

    3. PREG_OFFSET_CAPTURE: Si se pasa este marcador, cada coincidencia encontrada devolverá su desplazamiento relativo a la cadena de destino.

  • offset: Normalmente, la búsqueda comienza desde el inicio de la cadena objetivo. El parámetro opcional offset se utiliza para comenzar la búsqueda desde una posición especificada en la cadena objetivo (en bytes).

Valor de retorno

Devuelve el número de coincidencias completas (posiblemente 0), o FALSE si ocurre un error.

Ejemplos

Buscar el contenido que coincide con las etiquetas <b> y </b>:

<?php $userinfo = "Name: <b>PHP</b> <br> Title: <b>Programming Language</b>"; preg_match_all ("/<b>(.*)<\/b>/U", $userinfo, $pat_array); print_r($pat_array[0]); ?>

El resultado de la ejecución es el siguiente:

Array
(
    [0] => <b>PHP</b>
    [1] => <b>Programming Language</b>
)

Buscar etiquetas HTML coincidentes (codicioso):

<?php //\\2 es un ejemplo de referencia posterior. Esto le dice a PCRE que debe coincidir con el segundo paréntesis de la expresión regular (aquí ([\w]+)) //Resultado de la coincidencia. Aquí se usan dos barras invertidas porque se utilizan comillas dobles. $html = "<b>bold text</b><a href=howdy.html>click me</a>"; preg_match_all("/(<([\w]+)[^>]*>)(.*?)(<\/\\2>)/", $html, $matches, PREG_SET_ORDER); foreach ($matches as $val) { echo "matched: " . $val[0] . "\n"; echo "part 1: " . $val[1] . "\n"; echo "part 2: " . $val[2] . "\n"; echo "part 3: " . $val[3] . "\n"; echo "part 4: " . $val[4] . "\n\n"; } ?>

El resultado de la ejecución es el siguiente:

matched: <b>bold text</b>
part 1: <b>
part 2: b
part 3: bold text
part 4: </b>

matched: <a href=howdy.html>click me</a>
part 1: <a href=howdy.html>
part 2: a
part 3: click me
part 4: </a>

Expresiones regulares de PHP (PCRE)

Otras extensiones