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
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
offsetopcional 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
encodingfor omitido ounull, presume-se que astringesteja 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.
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
