Manual do PHP
Anterior |  | Próxima

# stripos

(PHP 5)

stripos -- Encontra a primeira ocorrencia de uma string sem diferenciar maiúsculas e minúsculas

## Descrição

int stripos ( string 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`.

Atenção
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().

Anterior | Principal | Próxima
stripcslashes | Acima | stripslashes