# stristr

(PHP 4, PHP 5, PHP 7, PHP 8)

stristr — strstr() insensible a mayúsculas y minúsculas

### Descripción

stristr(string `$haystack`, mixed `$needle`, bool `$before_needle` = `false`): string

Devuelve todo de `haystack` iniciando desde e incluyendo la primera aparición de `needle` hasta el final.

### Parámetros

`haystack`

  El string en donde buscar

`needle`

  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 del `haystack` anterior a la primera aparición del `needle` (excluyendo el needle).

`needle` y `haystack` se examinan de una manera insensible a mayúsculas y minúsculas.

### Valores devueltos

Devuelve el substring coincidente. Si no se encuentra `needle`, devuelve `false`.

### Historial de cambios

Versión | Descripción
--- | ---
5.3.0 | Agregado el parámetro opcional `before_needle`.
4.3.0 | stristr() se hizo seguro a nivel binario.

### Ejemplos

Ejemplo #1 Ejemplo de stristr()

`<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // salida ER@EXAMPLE.com
echo stristr($email, 'e', true); // A partir de PHP 5.3.0, salida US
?>`

Ejemplo #2 Probando si un string se encuentra o no

`<?php
$string = 'Hello World!';
if(stristr($string, 'earth') === FALSE) {
echo '"earth" not found in string';
}
// salida: "earth" not found in string
?>`

Ejemplo #3 Utilizando un needle no "string"

`<?php
$string = 'APPLE';
echo stristr($string, 97); // 97 = a minúscula
// salida: APPLE
?>`

### Notas

> Nota: Esta función es segura binariamente.

### Ver también

- strstr() - Encuentra la primera aparición de un string
- strrchr() - Encuentra la última aparición de un caracter en un string
- stripos() - Encuentra la posición de la primera aparición de un substring en un string sin considerar mayúsculas ni minúsculas
- strpbrk() - Buscar una cadena por cualquiera de los elementos de un conjunto de caracteres
- preg_match() - Realiza una comparación con una expresión regular