Fonction InStr
Renvoie une variante (Long) spécifiant la position de la première occurrence d’une chaîne au sein d’un autre.
Remarque
Vous voulez développer des solutions qui étendent l’expérience Office sur plusieurs plateformes ? Découvrez le nouveau modèle de compléments Office. Les compléments Office ont un encombrement réduit par rapport aux compléments et solutions VSTO. Vous pouvez les créer à l’aide de pratiquement n’importe quelle technologie de programmation web, telle que HTML5, JavaScript, CSS3 et XML.
Syntaxe
InStr([ start ], string1, string2, [ compare ])
La syntaxe de la fonction InStr comporte les arguments nommés suivants:
| Élément | Description |
|---|---|
| start | Facultatif. Expression numérique qui définit la position de départ pour chaque recherche. Si cet argument est omis, la recherche commence au début de caractère. SiDémarrer contient Null, une erreur se produit. L’argumentDémarrer est obligatoire sicomparer est spécifié. |
| string1 | Obligatoire. Expression de chaîne recherchée. |
| string2 | Obligatoire. Expression String recherchée. |
| comparer | Facultatif. Spécifie le type de comparaison de chaîne. Si compare a la valeur Null, une erreur se produit. Si comparer est omis, le paramètre Option comparer détermine le type de comparaison. Spécifiez un LCID valide (LocaleID) afin d’utiliser les règles de paramètres régionaux spécifiques dans la comparaison. |
Paramètres
Les paramètres de l’argument comparersont les suivantes.
| Constante | Valeur | Description |
|---|---|---|
| vbUseCompareOption | -1 | Effectue une comparaison à l’aide du paramètre de l’option instruction Comparer. |
| vbBinaryCompare | 0 | Effectue une comparaison binaire. |
| vbTextCompare | 1 | Effectue une comparaison textuelle. |
| vbDatabaseCompare | 2 | Microsoft Access uniquement. Effectue une comparaison basée sur les informations dans votre base de données. |
Valeurs de retour
| Si | InStr renvoie |
|---|---|
| string1 est nulle | 0 |
| string1 est Null | Null |
| string2 est nulle | start |
| string2 est Null | Null |
| string2 introuvable. | 0 |
| string2 est trouvée dans string1 | Position à laquelle la correspondance est établie. |
| start>string2 | 0 |
Remarques
La fonction InStrB est utilisée avec les données octet contenues dans une chaîne. Au lieu de renvoyer la position du caractère de la première occurrence d’une chaîne au sein d’une autre, InStrB renvoie la position d’octet.
Exemple
Cet exemple utilise la fonction InStrpour renvoyer la position de la première occurrence d’une chaîne au sein d’un autre.
Dim SearchString, SearchChar, MyPos
SearchString ="XXpXXpXXPXXP" ' String to search in.
SearchChar = "P" ' Search for "P".
' A textual comparison starting at position 4. Returns 6.
MyPos = Instr(4, SearchString, SearchChar, 1)
' A binary comparison starting at position 1. Returns 9.
MyPos = Instr(1, SearchString, SearchChar, 0)
' Comparison is binary by default (last argument is omitted).
MyPos = Instr(SearchString, SearchChar) ' Returns 9.
MyPos = Instr(1, SearchString, "W") ' Returns 0.
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.