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 chaîne de caractères completo.

needle

El chaîne de caractères 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 chaîne de caractères.

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 devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por 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