(PHP 5, PHP 7, PHP 8)
iconv_strpos — Localiza a posição da primeira ocorrência de um caractere em uma string
$haystack,$needle,$offset = 0,$encoding = null
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.
haystackA string inteira.
needleA 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 offsets negativas foi adicionado.
|