Strings.InStr Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un intero che specifica la posizione iniziale della prima occorrenza di una stringa all'interno di un'altra. L'intero è un indice in base uno se viene trovata una corrispondenza. Se non viene trovata alcuna corrispondenza, la funzione restituisce zero.
Overload
| Nome | Descrizione |
|---|---|
| InStr(Int32, String, String, CompareMethod) |
Restituisce un intero che specifica la posizione iniziale della prima occorrenza di una stringa all'interno di un'altra. |
| InStr(String, String, CompareMethod) |
Restituisce un intero che specifica la posizione iniziale della prima occorrenza di una stringa all'interno di un'altra. |
InStr(Int32, String, String, CompareMethod)
Restituisce un intero che specifica la posizione iniziale della prima occorrenza di una stringa all'interno di 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
- StartStartPos
- Int32
Optional. Espressione numerica che imposta la posizione iniziale per ogni ricerca. Se omesso, la ricerca inizia in corrispondenza della posizione del primo carattere. L'indice iniziale è basato su 1.
- String1
- String
Required.
String espressione in cui viene eseguita la ricerca.
- String2
- String
Required.
String espressione ricercata.
- Compare
- CompareMethod
Optional. Specifica il tipo di confronto tra stringhe. Se Compare viene omesso, l'impostazione Option Compare determina il tipo di confronto.
Valori restituiti
| Se | InStr restituisce |
|---|---|
String1 è di lunghezza zero o Nothing | 0 |
String2 è di lunghezza zero o Nothing |
start
|
String2 non è stato trovato | 0 |
String2 è stato trovato all'interno String1 | Posizione in cui inizia la corrispondenza |
Start
> lunghezza di String1 | 0 |
Eccezioni
Start
< 1.
Esempio
In questo esempio viene utilizzata la InStr funzione per restituire la posizione della prima occorrenza di una stringa all'interno di 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.
Note
La funzione InStrB 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 di set di caratteri a byte doppio (DBCS). Tutte le stringhe Visual Basic 2005 sono in Unicode e InStrB non sono più supportate.
Le impostazioni dell'argomento Compare sono:
| Costante | Value | Description |
|---|---|---|
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
- Strings in Visual Basic
- Introduzione alle stringhe in Visual Basic
- Istruzione Option Compare
Si applica a
InStr(String, String, CompareMethod)
Restituisce un intero che specifica la posizione iniziale della prima occorrenza di una stringa all'interno di 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
Required.
String espressione in cui viene eseguita la ricerca.
- String2
- String
Required.
String espressione ricercata.
- Compare
- CompareMethod
Optional. Specifica il tipo di confronto tra stringhe. Se Compare viene omesso, l'impostazione Option Compare determina il tipo di confronto.
Valori restituiti
| Se | InStr restituisce |
|---|---|
String1 è di lunghezza zero o Nothing | 0 |
String2 è di lunghezza zero o Nothing | Posizione iniziale per la ricerca, che per impostazione predefinita corrisponde alla prima posizione del carattere. |
String2 non è stato trovato | 0 |
String2 è stato trovato all'interno String1 | Posizione in cui inizia la corrispondenza. |
Esempio
In questo esempio viene utilizzata la InStr funzione per restituire la posizione della prima occorrenza di una stringa all'interno di un'altra. Nel primo esempio, la ricerca inizia dal quarto carattere e restituisce il successivo minuscolo "p" perché CompareMethod è Text e pertanto 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.
Note
La funzione InStrB 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 di set di caratteri a byte doppio (DBCS). Tutte le stringhe Visual Basic 2005 sono in Unicode e InStrB non sono più supportate.
Le impostazioni dell'argomento Compare sono:
| Costante | Value | Description |
|---|---|---|
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
- Strings in Visual Basic
- Introduzione alle stringhe in Visual Basic
- Istruzione Option Compare