stristr

(PHP 4, PHP 5)

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

Descripción

string stristr ( string $haystack , mixed $needle [, bool $before_needle = false ] )

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 un string, se convierte a un integer y se aplica como el valor ordinal de un caracter.

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