strpos

(PHP 3, PHP 4 )

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.

Se needle não for encontrado, retorna FALSE.

Nota: É fácil confundir os valores de retorno para "caractere encontrado na posição 0" e "caractere não encontrado". Aqui esta como detectar a diferença:

// no PHP 4.0b3 e mais recentes:
$pos = strpos($mystring, "b");
if ($pos === false) { // nota: três sinais de igual
    // não encontrado...
}

// em versões anteriores a 4.0b3:
$pos = strpos($mystring, "b");
if (!is_integer($pos)) {
    // não encontrado...
}

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().