eregi
(PHP 4, PHP 5)
eregi — Comparación de una expresión regular de forma insensible a mayúsculas-minúsculas
Descripción
$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.
Parámetros
-
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
patterny la función es llamada con el tercer argumentoregs, las coincidencias serán almacenadas en los elementos de la matrizregs.$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.
Valores devueltos
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.
Ejemplos
Ejemplo #1 Ejemplo de eregi()
<?php
$cadena = 'XYZ';
if (eregi('z', $cadena)) {
echo "¡'$cadena' contiene una 'z' o 'Z'!";
}
?>
Notas
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.
Ver también
- ereg() - Comparación de una expresión regular
- ereg_replace() - Sustituye una expresión regular
- eregi_replace() - Sustituye una expresión regular de forma insensible a mayúsculas-minúsculas
- preg_match() - Realiza una comparación con una expresión regular
- stripos() - Encuentra la posición de la primera aparición de un substring en un string sin considerar mayúsculas ni minúsculas
- stristr() - strstr insensible a mayúsculas y minúsculas
- quotemeta() - Escapa meta caracteres