InStr, fonction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition InStr, fonction

Description

Renvoie 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 renvoyées

La fonction InStr renvoie les valeurs suivantes :

Si la fonction InStr renvoie

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

Notes

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"						' Recherche "P".
MyPos = Instr(4, SearchString, SearchChar, 1)	' Comparaison textuelle commençant à la
								' position 4. Renvoie 6.	
MyPos = Instr(1, SearchString, SearchChar, 0)	' Comparaison binaire commençant à la			
								' position 1. Renvoie 9.
MyPos = Instr(SearchString, SearchChar)		' La comparaison est binaire par défaut
								' (le dernier argument est omis).
								' Renvoie 9.
MyPos = Instr(1, SearchString, "W")			' Comparaison binaire commençant à la position 1.								
								' Renvoie 0 ("W" est introuvable).        
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 renvoyer la position du caractère de la première occurrence d'une chaîne à l'intérieur d'une autre, la fonction InStrB renvoie la position de l'octet.

previous page start next page

É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.

Constante	Valeur	Description
vbBinaryCompare	0	Effectue une comparaison binaire.
vbTextCompare	1	Effectue une comparaison texte.

Si	la fonction InStr renvoie
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


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 renvoyer la position du caractère de la première occurrence d'une chaîne à l'intérieur d'une autre, la fonction InStrB renvoie la position de l'octet.