(PHP 5, PHP 7, PHP 8)
iconv_strpos — Localiza a posição da primeira ocorrência de um caractere em uma string
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.
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.
Retorna a posição numérica da primeira ocorrência de needle
em haystack
.
Se needle
não for encontrada, iconv_strpos() retornará false
.
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.
Versão | Descrição |
---|---|
8.0.0 | encoding é anulável agora. |
7.1.0 | O suporte para offset s negativas foi adicionado. |