Descrição

stripos(string $haystack, string $needle, int $offset = 0): int|false

Encontra a posição da primeira ocorrência de needle na sring haystack.

Diferentemente de strpos(), stripos() é insensível a maiúsculas/minúsculas.

Parâmetros

haystack

A string onde a substring será procurada.

needle

A substring sendo pesquisada.

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.

offset

Se especificado, a pesquisa iniciará nesse número de caracteres contados a partir do início da string. Se o deslocamento for negativo, a busca iniciará nesse número de caracteres contados a partir do final da string.

Valor Retornado

Retorna a posição onde a substring pesquisada existe em relação ao início da string haystack (independente do deslocamento). Observe também que as posições das strings começam em 0 e não em 1.

Retorna false se a substring não for encontrada.

Aviso

Esta função pode retornar o valor booleano false, mas também pode retornar um valor não booleano que pode ser avaliado como false. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

Erros/Exceções

Se offset for maior que o comprimento de haystack, um ValueError será lançado.

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.
7.1.0	Suporte para valores negativos em `offset` foi adicionado.

Exemplos

Exemplo #1 Exemplos de stripos()

<?php
$findme    = 'a';
$mystring1 = 'xyz';
$mystring2 = 'ABC';

$pos1 = stripos($mystring1, $findme);
$pos2 = stripos($mystring2, $findme);

// Não, 'a' certamente não existe em 'xyz'
if ($pos1 === false) {
    echo "A string '$findme' não foi encontrada na string '$mystring1'", PHP_EOL;
}

// Observe o uso de !==.  Simplesmente != não iria funcionar como esperado
// porque a posição de 'a' é na posição 0 (primeiro) caractere.
if ($pos2 !== false) {
    echo "Encontrado '$findme' em '$mystring2' na posição $pos2", PHP_EOL;
}
?>

Notas

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

Veja Também

mb_stripos() - Encontra a posição da primeira ocorrência de uma string dentro de outra, sem diferenciar maiúsculas de minúsculas
str_contains() - Determina se uma string contém uma substring fornecida
str_ends_with() - Verifica se uma string termina com uma substring fornecida
str_starts_with() - Verifica se uma string começa com uma substring fornecida
strpos() - Encontra a posição da primeira ocorrência de uma substring em uma string
strrpos() - Encontra a posição da última ocorrência de uma substring em uma string
strripos() - Encontra a posição da última ocorrência de uma substring em uma string, insensível a miúsculas/minúsculas
stristr() - strstr insensível a maiúsculas/minúsculas
substr() - Retorna parte de uma string
str_ireplace() - Versão insensível a maiúsculas/minúsculas de str_replace