(PHP 4, PHP 5)
ereg — Comparación de una expresión regular
$pattern
, string $string
[, array &$regs
] )
Busca en string
coincidencias con la expresión
regular dada en pattern
de una forma sensible a
mayúsculas-minúsculas.
Esta función ha sido declarada OBSOLETA desde PHP 5.3.0. Su uso está totalmente desaconsejado.
pattern
Expresión regular sensible a mayúsculas-minúsculas.
string
La cadena de entrada.
regs
Si se encontraron coincidencias con las sub-cadenas entre paréntesis de
pattern
y la función es llamada con el
tercer argumento regs
, las coincidencias serán almacenadas
en los elementos de la matriz regs
.
$registros[1] contendrá la sub-cadena que comienza con el primer paréntesis de la izquierda; $registros[2] contendrá la segunda sub-cadena, y así sucesivamente. $registros[0] contendrá una copia de la cadena coincidente completa.
Devuelve la longitud de la cadena coincidente si una coincidencia de
pattern
se encontró en string
,
o FALSE
si no se encontraron coincidencias o se produjo un error.
Si el parámetro opcional regs
no fue pasado o
la longitud de la cadena coincidente es 0, esta función devuelve 1.
Versión | Descripción |
---|---|
4.1.0 | Hasta PHP 4.1.0 (inclusive) $registros será rellenado con exactamente diez elementos, incluso si en realidad se pueden haber comparado más o menos de diez sub-cadenas entre paréntesis. Esto no tiene efecto en la capacidad que tiene ereg() de comparar más sub-cadenas. Si no se encontraron coincidencias, $registros no será modificado por ereg(). |
Ejemplo #1 Ejemplo de ereg()
El siguiente trozo de código toma una fecha en formato ISO (AAAA-MM-DD) y la imprime en formato DD.MM.AAAA:
<?php
if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $fecha, $registros)) {
echo "$registros[3].$registros[2].$registros[1]";
} else {
echo "Formato de fecha no válido: $fecha";
}
?>
Nota:
Desde PHP 5.3.0, la extensión regex queda obsoleta y en su lugar se utiliza extensión PCRE. Si se llama a esta función creará un aviso
E_DEPRECATED
. Ver El listado de diferencias para obtener ayuda a convertir a PCRE.
ereg() está obsoleta a partir de PHP 5.3.0. preg_match() es la alternativa sugerida a esta función.