strpos
(PHP 4, PHP 5)
strpos — Encontra a posição da primeira ocorrência de uma string
Descrição
Retorna a posição numérica da primeira ocorrência de needle dentro de haystack . Diferentemente de strrpos(), esta função pode ter uma string inteira como o parâmetro needle e toda a string será usada.
Se needle não for encontrado, strpos() irá retornar o 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.
Example#1 Exemplos strpos()
<?php
$mystring = 'abc';
$findme = 'a';
$pos = strpos($mystring, $findme);
// Note o uso de ===. Simples == não funcionaria como esperado
// por causa da posição de 'a' é 0 (primeiro) caractere.
if ($pos === false) {
echo "A string '$findme' não foi encontrada na string '$mystring'";
} else {
echo "A string '$findme' foi encontrada na string '$mystring'";
echo " e existe na posição $pos";
}
?>
Se o parâmetro needle não é uma string, é convertido para um inteiro e aplicado o valor do caractere.
O parâmetro opcional offset permite a você definir a partir de qual caractere em haystack iniciar a busca. A posição retorna ainda é relativa ao inicio de haystack .
Veja também strrpos(), strrchr(), substr(), stristr(), e strstr().