strpos

(PHP 3, PHP 4 , PHP 5)

strpos --  Encontra a posição da primeira ocorrência de uma string

Descrição

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.

Veja também strrpos(), strrchr(), substr(), stristr(), e strstr().