Strings.InStr Méthode

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne un entier spécifiant la position de début de la première occurrence d’une chaîne dans une autre. L’entier est un index basé sur un seul si une correspondance est trouvée. Si aucune correspondance n’est trouvée, la fonction retourne zéro.

Surcharges

Nom	Description
InStr(Int32, String, String, CompareMethod)	Retourne un entier spécifiant la position de début de la première occurrence d’une chaîne dans 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 dans une autre.

InStr(Int32, String, String, CompareMethod)

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Retourne un entier spécifiant la position de début de la première occurrence d’une chaîne dans une autre.

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

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

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

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

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

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

Paramètres

StartStartPos: Int32

Optional. Expression numérique qui définit la position de départ de chaque recherche. Si elle est omise, la recherche commence à la position du premier caractère. L’index de début est basé sur 1.

String1: String

Obligatoire. String expression recherchée.

String2: String

Obligatoire. String expression recherchée.

Compare: CompareMethod

Optional. Spécifie le type de comparaison de chaînes. S’il Compare est omis, le Option Compare paramètre détermine le type de comparaison.

Retours

Int32

Si	InStr retourne
`String1` est de longueur nulle ou `Nothing`	0
`String2` est de longueur nulle ou `Nothing`	`start`
`String2` est introuvable	0
`String2` est trouvé dans `String1`	Position où commence la correspondance
`Start` > longueur de `String1`	0

Exceptions

ArgumentException

Start < 1.

Exemples

Cet exemple utilise la InStr fonction pour retourner la position de la première occurrence d’une chaîne dans 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 fonction est utilisée lors de l’analyse InStr de chaînes.

Note

La fonction InStrB 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 n’est plus prise en charge.

Les Compare paramètres d’argument sont les suivants :

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

Voir aussi

S’applique à

InStr(String, String, CompareMethod)

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Retourne un entier spécifiant la position de début de la première occurrence d’une chaîne dans une autre.

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

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. String expression recherchée.

String2: String

Obligatoire. String expression recherchée.

Compare: CompareMethod

Optional. Spécifie le type de comparaison de chaînes. S’il Compare est omis, le Option Compare paramètre détermine le type de comparaison.

Retours

Int32

Si	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` est trouvé dans `String1`	Position où commence la correspondance.

Exemples

Cet exemple utilise la InStr fonction pour retourner la position de la première occurrence d’une chaîne dans une autre. Dans le premier exemple, la recherche commence à partir du quatrième caractère et retourne la minuscule suivante « p », car CompareMethod elle n’est Text donc pas sensible à 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 fonction est utilisée lors de l’analyse InStr de chaînes.

Note

Les Compare paramètres d’argument sont les suivants :

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

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?