(PHP 4, PHP 5)
eregi — Comparación de una expresión regular de forma insensible a mayúsculas-minúsculas
$pattern
, string $string
[, array &$regs
] )Esta función es idéntica a ereg() excepto que ignora la distinción de mayúsculas-minúsculas cuando se comparan caracteres alfanuméricos.
Esta función ha sido declarada OBSOLETA desde PHP 5.3.0. Su uso está totalmente desaconsejado.
pattern
Expresión regular insensible 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
.
$regs[1] contendrá la sub-cadena que comienza con el primer paréntesis de la izquierda; $regs[2] contendrá la segunda sub-cadena, y así sucesivamente. $regs[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.
Ejemplo #1 Ejemplo de eregi()
<?php
$cadena = 'XYZ';
if (eregi('z', $cadena)) {
echo "¡'$cadena' contiene una 'z' o 'Z'!";
}
?>
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.
eregi() está obsoleta a partir de PHP 5.3.0. preg_match()
con el modificador i (PCRE_CASELESS
) es la alternativa sugerida.