Microsoft® Visual Basic® Scripting Edition
InStr, fonction Référence du langage
Version 1
Voir aussi
--------------------------------------------------------------------------------
Description
Retourne la position de la première occurrence d'une chaîne à l'intérieur d'une autre.
Syntaxe
InStr([start, ]string1, string2[, compare])
La syntaxe de la fonction InStr comprend les éléments suivants :
élément Description
start Facultatif. Expression numérique qui définit la position de départ de chaque recherche. Si cet argument est omis, la recherche commence à la position du premier caractère. Si l'argument start contient la valeur Null, une erreur se produit. L'argument start est requis si l'argument compare est spécifié.
string1 Expression de chaîne faisant l'objet de la recherche.
string2 Expression de chaîne recherchée.
compare Facultatif. Valeur numérique qui indique le type de comparaison effectué lors de l'évaluation des sous- chaînes. Reportez-vous à la section Valeurs. Si l'argument compare est omis, une comparaison binaire est effectuée.
Valeurs
L'argument compare peut prendre les valeurs suivantes :
Constante Valeur Description
vbBinaryCompare 0 Effectue une comparaison binaire.
vbTextCompare 1 Effectue une comparaison texte.
Valeurs retournées
La fonction InStr retourne les valeurs suivantes :
Si la fonction InStr retourne
string1 est de longueur nulle 0
string1 est Null Null
string2 est de longueur nulle start
string2 est Null Null
string2 n'est pas trouvé 0
string2 est trouvé dans string1 la position de correspondance
start > Len(string2) 0
Note
Les exemples suivants utilisent la fonction InStr pour rechercher une chaîne :
Dim SearchString, SearchChar, MyPos
SearchString ="XXpXXpXXPXXP" ' Chaîne dans laquelle rechercher.
SearchChar = "P" ' Rechercher "P".
' Comparaison textuelle commençant à la position 4. Retourne 6.
MyPos = Instr(4, SearchString,
SearchChar, 1)
' Comparaison binaire commençant à la position 1. Retourne 9.
MyPos = Instr(1, SearchString,
SearchChar, 0)
' La comparaison est binaire par défaut (le dernier argument est omis).
MyPos = Instr(SearchString, SearchChar) ' Retourne 9.
' Comparaison binaire commençant à la position 1. Retourne 0 ("W" est introuvable).
MyPos = Instr(1, SearchString,
"W")
--------------------------------------------------------------------------------
Remarque Une autre fonction (InStrB) est disponible pour être utilisée avec les données de type octet contenues dans une chaîne. Au lieu de retourner la position du caractère de la première occurrence d'une chaîne à l'intérieur d'une autre, la fonction InStrB retourne la position de l'octet.
Partager