array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.stristr.php', 1 => 'stristr', 2 => 'strstr insensível a maiúsculas/minúsculas', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.stripslashes.php', 1 => 'stripslashes', ), 'next' => array ( 0 => 'function.strlen.php', 1 => 'strlen', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/stristr.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 foi descontinuado 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 foi descontinuado.

Exemplos

Exemplo #1 Exemplo de stristr()

<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'), PHP_EOL; // mostra ER@EXAMPLE.com
echo stristr($email, 'e', true), PHP_EOL; // 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
?>

Notas

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

Veja Também