Partager via


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.