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
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 jeux 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
offsetspécifie la position à partir de laquelle la recherche doit commencer. Si la position est négative, elle est compté depuis la fin de la chaîne de caractères -
encoding -
Si le paramètre
encodingest omis ounull,stringsera 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.
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 |
Suppport pour les offsets 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
add a note
