mb_ereg

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_eregBúsqueda por expresión regular con soporte para caracteres multibyte

Descripción

mb_ereg(string $pattern, string $string, array &$matches = null): bool

Búsqueda por expresión regular con soporte para caracteres multibyte.

Parámetros

pattern

El patrón de búsqueda.

string

La cadena sobre la que se realiza la búsqueda.

matches

Si se encuentran coincidencias para las subcadenas entre paréntesis de pattern y si la función es llamada con el tercer argumento matches, las coincidencias serán almacenadas en los elementos del array matches. Si no se encuentra ninguna coincidencia, matches tendrá como valor un array vacío.

$matches[1] contendrá la subcadena que comienza en la primera paréntesis izquierdo; $matches[2] contendrá la subcadena que comienza en la segunda, y así sucesivamente. $matches[0] contendrá una copia de la cadena completa coincidente.

Valores devueltos

Devuelve si se ha encontrado una coincidencia de pattern en string.

Historial de cambios

Versión Descripción
8.0.0 Esta función devuelve ahora true en caso de éxito. Anteriormente, devolvía la longitud en bytes de la cadena encontrada, si se encontraba una coincidencia para pattern en string y si se proporcionaba matches. Si el parámetro opcional matches no se proporcionaba o si la longitud de la cadena coincidente era 0, esta función devolvía 1.
7.1.0 mb_ereg() ahora asignará matches a un array vacío, si no hay coincidencias. Anteriormente, los matches no se modificaban en este caso.

Notas

Nota:

La codificación interna o la codificación especificada por mb_regex_encoding() será usada en esta función.

Ver también

  • mb_regex_encoding() - Define/Recupera la codificación de caracteres para las expresiones regulares multioctetos
  • mb_eregi() - Expresión regular insensible a mayúsculas/minúsculas con soporte para caracteres multioctetos