(PHP 4, PHP 5, PHP 7)
strpos — Encontra a posição da primeira ocorrência de uma 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.
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.
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
.
Veja também strrpos(), strrchr(), substr(), stristr(), e strstr().