PHP Conference Japan 2024

iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strposEncuentra la posición de la primera aparición de una aguja en un pajar

Descripción

iconv_strpos(
    string $haystack,
    string $needle,
    int $offset = 0,
    string $charset = ini_get("iconv.internal_encoding")
): int

Encuentra la posición de la primera aparición de una aguja dentro de un pajar.

A diferencia de strpos(), el valor que retorna iconv_strpos() es el número de caracteres que aparecen antes del string buscado, en vez del offset en bytes a la posición donde se encuentra el string. Los caracteres se cuentan de acuerdo a la codificación de caracteres establecida en charset.

Parámetros

haystack

El string completo donde buscar.

needle

El string a buscar.

offset

El parámetro opcional offset especifica la posición respecto al inicio del string desde la que empezará la búsqueda. Si el parámetro offset es negativo, se cuenta desde el final del string.

charset

Si se omite el parámetro charset, se asume que string se codificará según iconv.internal_encoding.

Si haystack o needle no son un string, se convierten a string y se aplica como el valor ordinal del carácter.

Valores devueltos

Retorna la posición numérica de la primera vez que aparece needle en haystack.

Si no se encuentra needle, iconv_strpos() retornará 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
7.1.0 Añadido soporte para offsets negativos.

Ver también

  • strpos() - Encuentra la posición de la primera ocurrencia de un substring en un string
  • iconv_strrpos() - Busca la última aparición de un string
  • mb_strpos() - Busca la posición de la primera ocurrencia de un string en otro string

add a note

User Contributed Notes

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