mb_strpos

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_strpos — Repère la première occurrence d'un caractère dans une chaîne

Description

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

Repère la position de la première occurrence de needle dans la chaîne haystack.

Effectue une recherche de type strpos(), en tenant compte des caractères multioctets. La position de needle est comptée à partir du début de la chaîne haystack : les positions commencent à 0.

Liste de paramètres

haystack: La chaîne dans laquelle récupérer la position de la première occurrence de needle
needle: La chaîne de caractères à trouver dans le paramètre haystack. A contrario de la fonction strpos(), les valeurs numériques ne sont pas appliquées comme valeur ordinale d'un caractère.
offset: La position de début de recherche. S'il est omis, zéro sera utilisé. Une position négative compte à partir de la fin de la chaîne de caractères.
encoding: Le paramètre encoding est l'encodage des caractères. S'il est omis ou null, l'encodage de caractères interne sera utilisé.

Valeurs de retour

Retourne la position numérique de la première occurrence du caractère needle dans la chaîne haystack. Si needle est introuvable, mb_strpos() retourne false.

Erreurs / Exceptions

Si offset est supérieur à la longueur de haystack, une ValueError sera levée.

Historique

Version	Description
8.0.0	`needle` accepte désormais une chaîne vide.
8.0.0	`encoding` est désormais nullable.
7.1.0	Support pour `offset`s négatifs a été ajouté.

Voir aussi

mb_internal_encoding() - Lit/modifie l'encodage interne
strpos() - Cherche la position de la première occurrence dans une chaîne