Partager via


Strings.InStr Méthode

Définition

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

IfLa fonction InStr retourne
String1 est de longueur nulle ou Nothing0
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 String10

Exceptions

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

IfLa fonction InStr retourne
String1 est de longueur nulle ou Nothing0
String2 est de longueur nulle ou NothingPosition 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 String1Position 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

S’applique à