PHPCon Poland 2024

iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strposLocaliza 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 offsets negativas foi adicionado.

Veja Também

  • strpos() - Find the position of the first occurrence of a substring in a string
  • iconv_strrpos() - Localiza a última ocorrência de um caractere em uma string
  • mb_strpos() - Encontrar a posição da primeira ocorrência de uma string em outra

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top