(PHP 4, PHP 5, PHP 7, PHP 8)
stristr — Versión insensible a mayúsculas y minúsculas de strstr()
Devuelve una subcadena de haystack
,
desde la primera ocurrencia de needle
(incluida) hasta el final de la cadena.
haystack
La cadena en la que se debe buscar.
needle
La cadena a buscar.
Si needle
no es una cadena, se convierte
a un entero y se aplica como el valor ordinal de un carácter.
Este comportamiento está obsoleto a partir de PHP 7.3.0, por lo que su uso está totalmente
desaconsejado. Dependiendo del comportamiento previsto,
needle
deberá ser convertido explícitamente a string,
o realizar 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.
Devuelve la parte correspondiente de la cadena. Si
needle
no se encuentra, la función
devuelve false
.
Versión | Descripción |
---|---|
8.2.0 | Case folding no longer depends on the locale set with setlocale(). Only ASCII case folding will be done. Non-ASCII bytes will be compared by their byte value. |
8.0.0 |
needle now accepts an empty string.
|
8.0.0 |
Pasar un entier como needle ya no está soportado.
|
7.3.0 |
Pasar un entier como before_needle se ha
marcado como obsoleto.
|
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
?>
Nota: Esta función es segura binariamente.