XOOPS Brasil

 

stristr

(PHP 4, PHP 5)

stristrstrstr() sem diferenciar maiúsculas e minúsculas

Descrição

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

Retorna tudo de haystack apartir da primeira ocorrência de needle até o final.

Parâmetros

haystack

A string onde será feita a busca.

needle

Se needle não é uma string, ela é convertida para inteiro e é usado como valor ordinal do caractere.

before_needle

Se TRUE (o padrão é FALSE), stristr() retorna a parte de haystack antes da primeira ocorrência de needle.

needle e haystack são examinadas de uma maneira que não diferencia maiúsculas e minúsculas.

Valor Retornado

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

Histórico

Versão Descrição
5.3.0 Adicionado o parâmetro opcional before_needle.
4.3.0 stristr() tornou-se binary safe.

Exemplos

Exemplo #1 Exemplo da stristr()

<?php
  $email 
'USER@EXAMPLE.com';
  echo 
stristr($email'e'); // outputs ER@EXAMPLE.com
  
echo stristr($email'e'true); // A partir do PHP 5.3.0, mostra US
?>

Exemplo #2 Testing if a string is found or not

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

Exemplo #3 Using a non "string" needle

<?php
  $string 
'APPLE';
  echo 
stristr($string97); // 97 = lowercase a
// outputs: APPLE
?>

Notas

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

Veja Também

  • strstr() - Encontra a primeira ocorrencia de uma string
  • strrchr() - Encontra a ultima ocorrência de um caractere em uma string
  • substr() - Retorna uma parte de uma string
  • preg_match() - Perform a regular expression match