Strings.InStr Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Restituisce un Integer che specifica la posizione di inizio della prima occorrenza di una stringa in un'altra. Il numero intero è un indice a base uno se viene individuata una corrispondenza. Se non viene rilevata alcuna corrispondenza, la funzione restituisce zero.

Overload

InStr(Int32, String, String, CompareMethod)	Restituisce un Integer che specifica la posizione di inizio della prima occorrenza di una stringa in un'altra.
InStr(String, String, CompareMethod)	Restituisce un Integer che specifica la posizione di inizio della prima occorrenza di una stringa in un'altra.

InStr(Int32, String, String, CompareMethod)

Source:

Strings.vb

Restituisce un Integer che specifica la posizione di inizio della prima occorrenza di una stringa in un'altra.

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

Parametri

Start

Int32

facoltativo. Espressione numerica che imposta la posizione iniziale di ogni ricerca. Se omesso, la ricerca inizia a partire dalla posizione del primo carattere. L'indice è in base 1.

String1

String

Obbligatorio. Espressione String in cui cercare.

String2

String

Obbligatorio. Espressione String cercata.

Compare

CompareMethod

facoltativo. Specifica il tipo di confronto delle stringhe. Se Compare viene omesso, il tipo di confronto viene determinato dall'impostazione di Option Compare.

Restituisce

Int32

Se	InStr restituirà
String1 è di lunghezza zero o Nothing	0
String2 è di lunghezza zero o Nothing	start
String2 non trovato.	0
String2 si trova all'interno di String1.	La posizione di inizio della corrispondenza
Start> lunghezza di String1	0

Eccezioni

ArgumentException

Start< 1.

Esempio

Nell'esempio riportato di seguito la funzione InStr viene utilizzata per restituire la posizione della prima occorrenza di una stringa in un'altra:

' 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")

Commenti

In genere, la funzione viene usata durante l'analisi InStr delle stringhe.

Nota

La InStrB funzione nelle versioni precedenti di Visual Basic restituisce un numero di byte anziché una posizione di caratteri. Viene usato principalmente per la conversione di stringhe in applicazioni DBCS (Double-Byte Character Set). Tutte le stringhe di Visual Basic 2005 sono in Formato Unicode e InStrB non sono più supportate.

Le impostazioni dell'argomento Compare sono le seguenti:

Costante	Valore	Descrizione
Binary	0	Esegue un confronto binario
Text	1	Esegue un confronto di testo

Vedi anche

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Stringhe in Visual Basic
• Introduzione alle stringhe in Visual Basic
• Istruzione Option Compare

InStr(String, String, CompareMethod)

Source:

Strings.vb

Restituisce un Integer che specifica la posizione di inizio della prima occorrenza di una stringa in un'altra.

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

Parametri

String1

String

Obbligatorio. Espressione String in cui cercare.

String2

String

Obbligatorio. Espressione String cercata.

Compare

CompareMethod

facoltativo. Specifica il tipo di confronto delle stringhe. Se Compare viene omesso, il tipo di confronto viene determinato dall'impostazione di Option Compare.

Restituisce

Int32

Se	InStr restituirà
String1 è di lunghezza zero o Nothing	0
String2 è di lunghezza zero o Nothing	Posizione iniziale per la ricerca, che viene impostata come predefinita in corrispondenza del primo carattere.
String2 non trovato.	0
String2 si trova all'interno di String1.	Posizione di inizio della corrispondenza.

Esempio

Nell'esempio riportato di seguito la funzione InStr viene utilizzata per restituire la posizione della prima occorrenza di una stringa in un'altra: Nel primo esempio, la ricerca inizia dal quarto carattere e restituisce la successiva minuscola "p" perché CompareMethod è Text e quindi senza distinzione tra maiuscole e minuscole. La posizione è sempre relativa all'inizio della stringa, indipendentemente dalla posizione iniziale.

' 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")

Commenti

In genere, la funzione viene usata durante l'analisi InStr delle stringhe.

Nota

La InStrB funzione nelle versioni precedenti di Visual Basic restituisce un numero di byte anziché una posizione di caratteri. Viene usato principalmente per la conversione di stringhe in applicazioni DBCS (Double-Byte Character Set). Tutte le stringhe di Visual Basic 2005 sono in Formato Unicode e InStrB non sono più supportate.

Le impostazioni dell'argomento Compare sono le seguenti:

Costante	Valore	Descrizione
Binary	0	Esegue un confronto binario
Text	1	Esegue un confronto di testo

Vedi anche

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Stringhe in Visual Basic
• Introduzione alle stringhe in Visual Basic
• Istruzione Option Compare