stristr

(PHP 4, PHP 5)

stristr — strstr() 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.

Changelog

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

Exemplos

Example #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
?>

Example #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
?>

Example #3 Using a non "string" needle

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

Notas

Note: Esta função é binary-safe.

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