Table of contents
TOC
Réduire la table des matières
Développer la table des matières

InStr, fonction

office 365 dev account|Dernière mise à jour: 04/10/2017
|
1 Contributeur

Renvoie une valeur de type Variant ( Long ) indiquant la position de la première occurrence d'une chaîne dans une autre.

Syntaxe

InStr ([ start , ] string1 , string2 [, compare ])

La syntaxe de la fonction InStr a les arguments suivants :

ÉlémentDescription
startFacultatif. Expression numérique qui définit la position de départ pour chaque recherche. Si vous l'omettez, la recherche commence à la position du premier caractère. Si start contient la valeur Null, une erreur se produit. L'argument start est obligatoire si compare est spécifié.
string1Requis. Expression String recherchée.
string2Requis. Expression String recherchée.
compareFacultatif. Spécifie le type de comparaison de chaînes. Si compare a la valeur Null, une erreur se produit. Si vous omettez compare, le paramètre OptionCompare détermine le type de comparaison. Spécifiez un LCID (LocaleID) valide pour utiliser des règles spécifiques aux paramètres régionaux dans la comparaison.

Paramètres

Les paramètres de l'argument compare sont les suivants :

ConstanteValeurDescription
vbUseCompareOption-1Effectue une comparaison à l'aide du paramètre de l'instruction Option Compare.
vbBinaryCompare0Effectue une comparaison binaire.
vbTextCompare1Effectue une comparaison textuelle.
vbDatabaseCompare2Microsoft Access uniquement. Effectue une comparaison basée sur les informations contenues dans votre base de données.

Valeurs renvoyées

SiInStr renvoie
string1 est de longueur nulle0
string1 est NullNull
string2 est de longueur nullestart
string2 est NullNull
string2 est introuvable0
string2 est trouvée dans string1Position à laquelle la correspondance est établie.
start > string20

Remarque

La fonction InStrB s'utilise avec des données d'octets contenues dans une chaîne. Au lieu de renvoyer la position de caractère de la première occurrence d'une chaîne dans une autre, InStrB renvoie la position d'octet.

Exemple

Cet exemple utilise la fonction InStr pour renvoyer la position de la première occurrence d'une chaîne dans une 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.
© 2018 Microsoft