(PHP 5, PHP 7)
stripos — Encontra a primeira ocorrencia de uma string sem diferenciar maiúsculas e minúsculas
$haystack
, string $needle
[, int $offset
] )
Retorna a posição numerica da primeira ocorrencia de
needle na string haystack.
Diferentemente de strpos(),
stripos() não diferencia maiúsculas e minúsculas.
Note que o parâmetro needle deve ser uma string de um
ou mais caracteres.
Se needle não for encontrada,
stripos() irá retornar boolean FALSE.
Esta função pode
retornar o booleano FALSE, mas também pode retornar um valor não-booleano que pode ser
avaliado como FALSE, como 0 ou
"". Leia a seção em Booleanos para maiores
informações. Utilize o operador ===
para testar o valor retornado por esta função.
Exemplo #1 Exemplos stripos()
<?php
$findme = 'a';
$mystring1 = 'xyz';
$mystring2 = 'ABC';
$pos1 = stripos($mystring1, $findme);
$pos2 = stripos($mystring2, $findme);
// 'a' certamente não esta em 'xyz'
if ($pos1 === false) {
echo "A string '$findme' não foi encontrada na string '$mystring1'";
}
// Note o nosso uso de ===. Simples == não funcionaria como o esperado
// porque a posição de 'a' é 0 (primeiro) caractere.
if ($pos2 !== false) {
echo "Nós encontramos '$findme' em '$mystring2' na posição $pos2";
}
?>
Se needle não é uma string, é convertida
para um inteiro e aplicado o valor do caractere.
O parâmetro opcional offset permite a você
especificar apartir de qual caractere em haystack
a procura começa. A posição retornada ainda é relativa ao
inicio de haystack.
Veja também strpos(), strrpos(), strrchr(), substr(), stristr(), strripos(), strstr() e stri_replace().