stristr

(PHP 4, PHP 5, PHP 7)

stristrstrstr() 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($string97); // 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