iconv_strpos

(PHP 5, PHP 7, PHP 8)

iconv_strpos — Trouve la position de la première occurrence d'une chaîne dans une autre

Description

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

Trouve la position de la première occurrence de needle dans haystack.

À l'opposé de strpos(), la valeur retournée par iconv_strpos() est le nombre de caractères se trouvant avant needle, plutôt que la position en octets où needle a été trouvé. Les caractères sont comptés en se basant sur le jeu de caractères spécifié par encoding.

Liste de paramètres

haystack: La chaîne de caractères entière.
needle: La chaîne de caractères à chercher.
offset: Le paramètre optionnel offset spécifie la position à partir de laquelle la recherche doit commencer. Si la position est négative, elle est comptée depuis la fin de la chaîne de caractères
encoding: Si le paramètre encoding est omis ou null, string sera encodé en accord avec iconv.internal_encoding.

Si haystack ou needle ne sont pas des chaînes de caractères, ils sont convertis en entiers et appliqués en tant que valeur ordinale d'un caractère.

Valeurs de retour

Retourne la position numérique de la première occurrence de needle dans haystack.

Si needle n'est pas trouvé, iconv_strpos() retournera false.

Avertissement

Cette fonction peut retourner false, mais elle peut aussi retourner une valeur équivalent à false. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Historique

Version	Description
8.0.0	`encoding` est désormais nullable.
7.1.0	Support pour les `offset`s négatifs a été ajouté.

Voir aussi

strpos() - Cherche la position de la première occurrence dans une chaîne
iconv_strrpos() - Trouve la position de la dernière occurrence d'un élément dans une chaîne
mb_strpos() - Repère la première occurrence d'un caractère dans une chaîne