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