preg_match

(PHP 3>= 3.0.9, PHP 4 )

preg_match -- Realiza un emparejamiento dada una expresión

Descripción

int preg_match ( string pattern, string subject [, array matches])

Busca en subject para un emparejamiento, dada la expresión pattern.

Si matches es dado, entonces será definido con el resultado de la búsqueda. $matches[0] contendrá el texto que empareja con el patrón en su totalidad. $matches[1] tendrá la cadena que empareje con el primer subpatrón que esté entre paréntesis y así sucesivamente.

Devuelve TRUE si se encontró en la cadena un emparejamiento dado el patrón pattern, FALSE si no se produjo o hubo un error.

Ejemplo 1. Obtener el número de la siguiente página dada una cadena

if (preg_match("/page\s+#(\d+)/i", "Go to page #9.", $parts))
    print "Next page is $parts[1]";             // La siguiente página es $parts[1]
else
    print "Page not found.";                    // Página no encontrada
Examinar también preg_match_all(), preg_replace(), y preg_split().