iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strpos — Encuentra 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 `offset`s 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.