Strings.InStr Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre. L'entier est un index basé sur 1 en cas de découverte d'une correspondance. Si aucune correspondance n'est trouvée, la fonction retourne zéro.

Surcharges

InStr(Int32, String, String, CompareMethod)	Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre.
InStr(String, String, CompareMethod)	Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre.

InStr(Int32, String, String, CompareMethod)

Source:

Strings.vb

Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre.

public static int InStr (int Start, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> int

Public Function InStr (Start As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Paramètres

Start

Int32

Optionnel. Expression numérique qui définit la position de départ de chaque recherche. Si ce paramètre est omis, la recherche commence à la position du premier caractère. L'index de début est de base 1.

String1

String

Obligatoire. Expression String dans laquelle est effectuée la recherche.

String2

String

Obligatoire. Expression String recherchée.

Compare

CompareMethod

Optionnel. Spécifie le type de comparaison de chaînes. Si Compare est omis, le paramètre Option Compare détermine le type de comparaison.

Retours

Int32

If	La fonction InStr retourne
String1 est de longueur nulle ou Nothing	0
String2 est de longueur nulle ou Nothing	start
String2 est introuvable.	0
String2 se trouve dans String1	Position où commence la correspondance
Start> longueur de String1	0

Exceptions

ArgumentException

Start< 1.

Exemples

L'exemple suivant utilise la fonction InStr pour retourner la position de la première occurrence d'une chaîne à l'intérieur d'une autre.

' String to search in.
Dim searchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim searchChar As String = "P"

Dim testPos As Integer
' A textual comparison starting at position 4. Returns 6.
testPos = InStr(4, searchString, searchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
testPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
testPos = InStr(searchString, searchChar)

' Returns 0.
testPos = InStr(1, searchString, "W")

Remarques

En règle générale, la InStr fonction est utilisée lors de l’analyse de chaînes.

Notes

La InStrB fonction dans les versions précédentes de Visual Basic retourne un nombre d’octets plutôt qu’une position de caractère. Elle est principalement utilisée pour convertir des chaînes dans les applications de jeu de caractères sur deux octets (DBCS). Toutes les chaînes Visual Basic 2005 sont en Unicode et InStrB ne sont plus prises en charge.

Les paramètres de l’argument Compare sont :

Constant	Valeur	Description
Binary	0	Effectue une comparaison binaire
Text	1	Effectue une comparaison de texte

Voir aussi

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Chaînes en Visual Basic
• Introduction aux chaînes en Visual Basic
• Option Compare, instruction

InStr(String, String, CompareMethod)

Source:

Strings.vb

Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre.

public static int InStr (string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member InStr : string * string * Microsoft.VisualBasic.CompareMethod -> int

Public Function InStr (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Paramètres

String1

String

Obligatoire. Expression String dans laquelle est effectuée la recherche.

String2

String

Obligatoire. Expression String recherchée.

Compare

CompareMethod

Optionnel. Spécifie le type de comparaison de chaînes. Si Compare est omis, le paramètre Option Compare détermine le type de comparaison.

Retours

Int32

If	La fonction InStr retourne
String1 est de longueur nulle ou Nothing	0
String2 est de longueur nulle ou Nothing	Position de départ de la recherche, qui correspond par défaut à la première position de caractère.
String2 est introuvable.	0
String2 se trouve dans String1	Position où commence la correspondance.

Exemples

L'exemple suivant utilise la fonction InStr pour retourner la position de la première occurrence d'une chaîne à l'intérieur d'une autre. Dans le premier exemple, la recherche commence à partir du quatrième caractère et retourne la minuscule suivante « p », car CompareMethod elle ne Text respecte pas la casse. La position est toujours relative au début de la chaîne, quelle que soit la position de début.

' String to search in.
Dim searchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim searchChar As String = "P"

Dim testPos As Integer
' A textual comparison starting at position 4. Returns 6.
testPos = InStr(4, searchString, searchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
testPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
testPos = InStr(searchString, searchChar)

' Returns 0.
testPos = InStr(1, searchString, "W")

Remarques

En règle générale, la InStr fonction est utilisée lors de l’analyse de chaînes.

Notes

La InStrB fonction dans les versions précédentes de Visual Basic retourne un nombre d’octets plutôt qu’une position de caractère. Elle est principalement utilisée pour convertir des chaînes dans les applications de jeu de caractères sur deux octets (DBCS). Toutes les chaînes Visual Basic 2005 sont en Unicode et InStrB ne sont plus prises en charge.

Les paramètres de l’argument Compare sont :

Constant	Valeur	Description
Binary	0	Effectue une comparaison binaire
Text	1	Effectue une comparaison de texte

Voir aussi

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Chaînes en Visual Basic
• Introduction aux chaînes en Visual Basic
• Option Compare, instruction