PHP | función preg_match()

Esta función busca el patrón en la string, devuelve verdadero si existe el patrón, de lo contrario devuelve falso. Por lo general, la búsqueda comienza desde el principio de la string de asunto. El parámetro opcional offset se usa para especificar la posición desde donde comenzar la búsqueda.

Sintaxis:

int preg_match( $pattern, $input, $matches, $flags, $offset )

Parámetros: esta función acepta cinco parámetros, como se mencionó anteriormente y se describe a continuación:

• patrón: este parámetro contiene el patrón a buscar, como una string.
• entrada: este parámetro contiene la string de entrada.
• coincidencias: si existen coincidencias, entonces contiene los resultados de la búsqueda. $coincidencias[0] contendrá el texto que coincidió con el patrón completo, $coincidencias[1] contendrá el texto que coincidió con el primer subpatrón entre paréntesis capturado, y así sucesivamente.
• banderas: Las banderas pueden ser las siguientes banderas:
  • PREG_OFFSET_CAPTURE: si se pasa este indicador, para cada coincidencia se devolverá el desplazamiento de la string adjunta.
  • PREG_UNMATCHED_AS_NULL: si se pasa este indicador, los subpatrones que no coinciden se notifican como NULL; de lo contrario, informan como una string vacía.
• offset: por lo general, la búsqueda comienza desde el principio de la string de entrada. Este parámetro opcional offset se usa para especificar el lugar desde donde comenzar la búsqueda (en bytes).

Valor devuelto: Devuelve verdadero si existe un patrón, de lo contrario, devuelve falso.

Los siguientes ejemplos ilustran la función preg_match() en PHP:

Ejemplo 1: este ejemplo acepta el indicador PREG_OFFSET_CAPTURE.

<?php
  
// Declare a variable and initialize it
$geeks = 'GeeksforGeeks';
  
// Use preg_match() function to check match
preg_match('/(Geeks)(for)(Geeks)/', $geeks, $matches, PREG_OFFSET_CAPTURE);
  
// Display matches result
print_r($matches);
  
?>

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

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

    [2] => Array
        (
            [0] => for
            [1] => 5
        )

    [3] => Array
        (
            [0] => Geeks
            [1] => 8
        )

)

Ejemplo 2:

<?php
  
// Declare a variable and initialize it
$gfg = "GFG is the best Platform.";
  
// case-Insensitive search for the word "GFG"
if (preg_match("/\bGFG\b/i", $gfg, $match)) 
    echo "Matched!";
else
    echo "not matched";
      
?>

Matched!

Referencia: http://php.net/manual/en/function.preg-match.php