Documentación offline PHP master

iconv_strpos

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

iconv_strpos

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

Descripción#

php iconv_strpos(string $haystack, string $needle, [int $offset], [string $encoding]): intphp

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.

[!WARNING] 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.

Véase también#

strpos, iconv_strrpos, mb_strpos