Funções PHP |
. Glossários Funções PHP - strpos ( ) |
(PHP 3, PHP 4 , PHP 5)
strpos -- Encontra a posição
da primeira ocorrência de uma string
int strpos ( string haystack, string needle [,
int offset])
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.
If needle não for encontrado, strpos() 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 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.
Exemplo:
Veja mais detalhes clicando aqui.
Veja também strrpos(), strrchr(), substr(), stristr(), e strstr().