| CARVIEW |
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
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 sur laquelle récupéré 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
encodingest l'encodage des caractères. S'il est omis ounull, 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
offsetest supérieur à la longueur dehaystack, 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 offsets 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
User Contributed Notes
