iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strpos — Localiza a posição da primeira ocorrência de um caractere em uma string

Descrição

iconv_strpos(
    string $haystack,
    string $needle,
    int $offset = 0,
    ?string $encoding = null
): int|false

Localiza a posição da primeira ocorrência de um needle em um haystack.

Em contraste com strpos(), o valor de retorno de iconv_strpos() é o número de caracteres que aparecem antes da agulha, em vez do deslocamento em bytes para a posição onde a agulha foi encontrada. Os caracteres são contados com base no encoding do conjunto de caracteres especificado.

Parâmetros

haystack: A string inteira.
needle: A substring pesquisada.
offset: O parâmetro offset opcional especifica a posição a partir da qual a pesquisa deve ser realizada. Se o offset for negativo, ele será contado a partir do final da string.
encoding: Se o parâmetro encoding for omitido ou null, presume-se que a string esteja codificada em iconv.internal_encoding.

Se haystack ou needle não for uma string, ela será convertida em uma string e aplicada como o valor ordinal de um caractere.

Valor Retornado

Retorna a posição numérica da primeira ocorrência de needle em haystack.

Se needle não for encontrada, iconv_strpos() retornará false.

Aviso

Esta função pode retornar o valor booleano false, mas também pode retornar um valor não booleano que pode ser avaliado como false. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

Registro de Alterações

Versão	Descrição
8.0.0	`encoding` é anulável agora.
7.1.0	O suporte para `offset`s negativas foi adicionado.

Veja Também

strpos() - Encontra a posição da primeira ocorrência de uma substring em uma string
iconv_strrpos() - Localiza a última ocorrência de um caractere em uma string
mb_strpos() - Encontra a posição da primeira ocorrência de uma string em outra