stristr

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

stristr — strstr() insensível a maiúsculas/minúsculas

Descrição

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

Retorna todo o haystack iniciando a partir de (e incluindo) a primeira ocorrência de needle até o final.

Parâmetros

haystack

A string onde será feita a pesquisa.

needle

A string que está sendo procurada.

Antes do PHP 8.0.0, se needle não for uma string, ela será convertida para um número inteiro e aplicada como o valor ordinal de um caractere. Este comportamento tornou-se defasado a partir do PHP 7.3.0 e depender dele é altamente desaconselhado. Dependendo do comportamento pretendido, o parâmetro needle deve ser explicitamente convertido em string ou uma chamada explícita para chr() deve ser realizada.

before_needle

Se igual a true, stristr() retorna a parte de haystack antes da primeira ocorrência de needle (excluindo-o).

needle e haystack são examinados de maneira insensível a maiúsculas/minúsculas.

Valor Retornado

Retorna a substring correspondente. Se needle não for encontrada, retorna false.

Registro de Alterações

Versão	Descrição
8.2.0	A redução de todas as letras a maiúsculas ou minúsculas não depende mais da localidade definida com setlocale(). Somente a redução de todas as letras ASCII a maiúsculas ou minúsculas será feita. Os bytes não ASCII serão comparados por seu valor de byte.
8.0.0	O parâmetro `needle` agora aceita uma string vazia.
8.0.0	Passar um int em `needle` não é mais suportado.
7.3.0	Passar um int em `needle` tornou-se defasado.

Exemplos

Exemplo #1 Exemplo de stristr()

<?php
  $email = 'USER@EXAMPLE.com';
  echo stristr($email, 'e'); // mostra ER@EXAMPLE.com
  echo stristr($email, 'e', true); // mostra US
?>

Exemplo #2 Testando se uma string é encontrada ou não

<?php
  $string = 'Olá Mundo!';
  if(stristr($string, 'Terra') === FALSE) {
    echo '"Terra" não encontrado na string';
  }
// mostra: "Terra" não encontrado na string
?>

Exemplo #3 Procurando por uma "não string"

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

Notas

Nota: Esta função é compatível com dados binários.

Veja Também

strstr() - Find the first occurrence of a string
strrchr() - Encontra a última ocorrência de um caractere em uma string
stripos() - Encontra a posição da primeira ocorrência de uma substring em uma string, de forma insensível a maiúsculas/minúsculas
strpbrk() - Procura na string por um dos caracteres de um conjunto
preg_match() - Perform a regular expression match

Improve This Page

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

＋add a note

User Contributed Notes 8 notes

down

dpatton.at.confluence.org ¶

21 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 ¶

16 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 ¶

21 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

down

-10

tomas dot nesrovnal at yourspirit dot cz ¶

15 years ago

Active item item in menu:

<?php
function aim($page) {
    if(stristr($_SERVER['REQUEST_URI'], $page)) {
        return ' class="active"';
    } 
}
?>

usage:

<style type="text/css">
.active {color: red;}
</style>

<?php
print '<a href="http://example.com/page/hello-world/"'. aim('hello-world') .'>HW</a>'; 
?>

down

-8

art at awilton dot dotcom ¶

18 years ago

handy little bit of code I wrote to take arguments from the command line and parse them for use in my apps.

<?php

 $i = implode(" ",$argv); //implode all the settings sent via clie
 $e = explode("-",$i); // no lets explode it using our defined seperator '-'

       //now lets parse the array and return the parameter name and its setting
       // since the input is being sent by the user via the command line
       //we will use stristr since we don't care about case sensitivity and
       //will convert them as needed later.

    while (list($index,$value) = each($e)){

       //lets grap the parameter name first using a double reverse string
       // to get the begining of the string in the array then reverse it again
       // to set it back. we will also "trim" off the "=" sign

     $param = rtrim(strrev(stristr(strrev($value),'=')),"=");

       //now lets get what the parameter is set to.
       // again "trimming" off the = sign

     $setting = ltrim(stristr($value,'='),"=");

       // now do something with our results.
       // let's just echo them out so we can see that everything is working

      echo "Array index is ".$index." and value is ".$value."\r\n";
      echo "Parameter is ".$param." and is set to ".$setting."\r\n\r\n";

}

?>

when run from the CLI this script returns the following.

[root@fedora4 ~]# php a.php -val1=one -val2=two -val3=three

Array index is 0 and value is a.php
Parameter is  and is set to

Array index is 1 and value is val1=one
Parameter is val1 and is set to one

Array index is 2 and value is val2=two
Parameter is val2 and is set to two

Array index is 3 and value is val3=three
Parameter is val3 and is set to three

[root@fedora4 ~]#

down

-14

greg at no_ggmac_reply dot com ¶

13 years ago

Beware the example given here:

if stristr($message,'viagra')
or stristr($message,'cialis')
)
{
die();
}

stristr does not search for words, it finds matching substrings.  So, for example, the check for 'cialis' will trigger on 'specialist'

＋add a note