stristr
(PHP 4, PHP 5, PHP 7, PHP 8)
stristr — Versión insensible a mayúsculas y minúsculas de strstr()
Parámetros
haystack-
La cadena en la que se debe buscar.
needle-
La cadena a buscar.
Anterior a PHP 8.0.0, si needle no es una cadena de caracteres,
se convierte en un entero y se aplica como valor ordinal de un carácter.
Este comportamiento está obsoleto a partir de PHP 7.3.0, y confiar en él
está fuertemente desaconsejado. Dependiendo del comportamiento esperado,
needle debe ser explícitamente convertido a una cadena de caracteres,
o debe realizarse una llamada explícita a chr().
before_needle-
Si es true, stristr()
devuelve la parte de haystack antes de la primera
ocurrencia de needle (needle
excluida).
needle y haystack
se tratan sin tener en cuenta mayúsculas y minúsculas.
Valores devueltos
Devuelve la parte correspondiente de la cadena. Si
needle no se encuentra, la función
devuelve false.
Ejemplos
Ejemplo #1 Ejemplo con stristr()
<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'), PHP_EOL; // muestra ER@EXAMPLE.com
echo stristr($email, 'e', true), PHP_EOL; // muestra US
?>
Ejemplo #2 Comprueba si una cadena es encontrada o no
<?php
$string = 'Hello World!';
if (stristr($string, 'earth') === FALSE) {
echo '"terre" no encontrado en la cadena';
}
// muestra: "terre" no encontrado en la cadena
?>
Notas
Nota: Esta función es
segura para sistemas binarios.
Ver también
- strstr() - Encuentra la primera ocurrencia en un string
- strrchr() - Encuentra la última ocurrencia de un carácter en un string
- stripos() - Busca la posición de la primera ocurrencia en un string, sin distinguir mayúsculas de minúsculas
- strpbrk() - Busca un conjunto de caracteres en un string
- preg_match() - Realiza una búsqueda de coincidencia con una expresión regular estándar
