Strings.InStr Méthode

Référence

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 à 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

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 à l'intérieur d'une autre.

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);

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 (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

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

Paramètres

StartStartPos: 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

S’applique à

InStr(String, String, CompareMethod)

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 à l'intérieur d'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. 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

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

S’applique à

Partager via

Strings.InStr Méthode

Définition

Surcharges

InStr(Int32, String, String, CompareMethod)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

InStr(String, String, CompareMethod)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires