Функция preg_match

La función preg_match busca coincidencias con una expresión regular en una cadena. El primer parámetro acepta el patrón de la expresión regular, el segundo - la cadena para buscar, el tercero (opcional) - el array para guardar las coincidencias encontradas, el cuarto (opcional) - banderas, el quinto (opcional) - desplazamiento del inicio de la búsqueda.

Sintaxis

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

Banderas

Ejemplo

Comprobemos si la cadena contiene dígitos:

php<?php
  $res = preg_match('/\d+/', 'abc123');
  echo $res;
?>

Resultado de ejecutar el código:

php1

Ejemplo

Extraigamos todos los dígitos de la cadena a un array:

php<?php
  preg_match('/\d+/', 'abc123', $matches);
  var_dump($matches);
?>

Resultado de ejecutar el código:

php[0 => '123']

Ejemplo

Uso de grupos con nombre en la expresión regular:

php<?php
  preg_match('/(?P<name>\w+)\s+(?P<age>\d+)/', 'John 25', $matches);
  var_dump($matches);
?>

Resultado de ejecutar el código:

php[
  0 => 'John 25',
  'name' => 'John',
  1 => 'John',
  'age' => '25',
  2 => '25'
]

Ejemplo

Uso de la bandera PREG_OFFSET_CAPTURE para obtener la posición de la coincidencia:

php<?php
  preg_match('/\d+/', 'abc123', $matches, PREG_OFFSET_CAPTURE);
  var_dump($matches);
?>

Resultado de ejecutar el código:

php[
  0 => [
    0 => '123',
    1 => 3
  ]
]

Ejemplo

Búsqueda con desplazamiento (offset) especificado:

php<?php
  preg_match('/\d+/', '123abc456', $matches, 0, 3);
  var_dump($matches);
?>

Resultado de ejecutar el código:

php[0 => '456']

Ejemplo

Comprobación de validez de dirección de email:

php<?php
  $email = 'test@example.com';
  $res = preg_match('/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/', $email);
  echo $res ? 'Valid' : 'Invalid';
?>

Resultado de ejecutar el código:

php'Valid'

Véase también