Manual do PHP
Anterior |  | Próxima

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

Anterior | Principal | Próxima
strpbrk | Acima | strrchr