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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 5 notes

down

dpatton.at.confluence.org ¶

22 years ago

There was a change in PHP 4.2.3 that can cause a warning message
to be generated when using stristr(), even though no message was
generated in older versions of PHP.

The following will generate a warning message in 4.0.6 and 4.2.3:
  stristr("haystack", "");
     OR
  $needle = "";  stristr("haystack", $needle);

This will _not_ generate an "Empty Delimiter" warning message in
4.0.6, but _will_ in 4.2.3:
  unset($needle); stristr("haystack", $needle);

Here's a URL that documents what was changed:
http://groups.google.ca/groups?selm=cvshholzgra1031224321%40cvsserver

down

giz at gbdesign dot net ¶

17 years ago

Just been caught out by stristr trying to converting the needle from an Int to an ASCII value.



Got round this by casting the value to a string.



<?php

if( !stristr( $file, (string) $myCustomer->getCustomerID()  ) ) {

  // Permission denied

}

?>

down

Techdeck at Techdeck dot org ¶

22 years ago

An example for the stristr() function:

<?php
$a = "I like php";
if (stristr("$a", "LikE PhP")) {
print ("According to \$a, you like PHP.");
}
?>

It will look in $a for "like php" (NOT case sensetive. though, strstr() is case-sensetive).

For the ones of you who uses linux.. It is similiar to the "grep" command.
Actually.. "grep -i".

down

-1

notepad at codewalkers dot com ¶

19 years ago

<?php



function stristr_reverse($haystack, $needle) {

  $pos = stripos($haystack, $needle) + strlen($needle);

  return substr($haystack, 0, $pos);

}

$email = 'USER@EXAMPLE.com';

echo stristr_reverse($email, 'er');

// outputs USER



?>

down

-3

jukka ¶

10 years ago

I think there is a bug in php 5.3 in stristr with uppercase Ä containing other character

http://pastebin.com/5bP6uztY

if you search only with täry it works, but as soon as the word is tärylä  it does not. TÄRYL works fine

＋add a note