PHP 8.5.0 Alpha 2 available for testing

iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strposEncuentra la posición de la primera ocurrencia de una cadena en otra

Descripción

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

Encuentra la posición de la primera ocurrencia de needle en haystack.

A diferencia de strpos(), el valor devuelto por iconv_strpos() es el número de caracteres que se encuentran antes de needle, en lugar de la posición en bytes donde needle fue encontrado. Los caracteres son contados basándose en el juego de caracteres especificado por encoding.

Parámetros

haystack

El string completo.

needle

El string a buscar.

offset

El parámetro opcional offset especifica la posición desde la cual debe comenzar la búsqueda. Si la posición es negativa, se cuenta desde el final del string.

encoding

Si el parámetro encoding es omitido o null, string será codificado de acuerdo con iconv.internal_encoding.

Si haystack o needle no son strings, son convertidos a enteros y aplicados como valor ordinal de un carácter.

Valores devueltos

Devuelve la posición numérica de la primera ocurrencia de needle en haystack.

Si needle no es encontrado, iconv_strpos() devolverá false.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

Historial de cambios

Versión Descripción
8.0.0 encoding ahora es nullable.
7.1.0 Se añadió soporte para offsets negativos.

Ver también

  • strpos() - Busca la posición de la primera ocurrencia en un string
  • iconv_strrpos() - Encuentra la posición de la última ocurrencia de un elemento en una cadena
  • mb_strpos() - Localiza la primera ocurrencia de un carácter en una cadena

add a note

User Contributed Notes

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