Strings.Split(String, String, Int32, CompareMethod) Metodo

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Restituisce una matrice unidimensionale in base zero contenente un numero specificato di sottostringhe.

public static string[] Split(string Expression, string Delimiter = " ", int Limit = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member Split : string * string * int * Microsoft.VisualBasic.CompareMethod -> string[]
Public Function Split (Expression As String, Optional Delimiter As String = " ", Optional Limit As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Parametri

Expression
String

Required. String espressione contenente sottostringhe e delimitatori.

Delimiter
String

Optional. Qualsiasi carattere singolo utilizzato per identificare i limiti di sottostringa. Se Delimiter viene omesso, si presuppone che lo spazio (" ") sia il delimitatore.

Limit
Int32

Optional. Numero massimo di sottostringhe in cui deve essere divisa la stringa di input. Il valore predefinito , -1, indica che la stringa di input deve essere divisa in ogni occorrenza della Delimiter stringa.

Compare
CompareMethod

Optional. Valore numerico che indica il confronto da usare durante la valutazione delle sottostringhe. Per i valori, vedere "Impostazioni".

Valori restituiti

String[]

Matrice String. Se Expression è una stringa di lunghezza zero (""), Split restituisce una matrice a singolo elemento contenente una stringa di lunghezza zero. Se Delimiter è una stringa di lunghezza zero o se non viene visualizzata da nessuna parte in Expression, Split restituisce una matrice a singolo elemento contenente l'intera Expression stringa.

Esempio

Nell'esempio seguente viene illustrato come suddividere una stringa nei relativi spazi.

Dim testString As String = "Look at these!"
' Returns an array containing "Look", "at", and "these!".
Dim testArray() As String = Split(testString)

Nell'esempio seguente viene illustrato come suddividere le stringhe con più delimitatori in una riga e filtrare le stringhe vuote.

Dim testString As String = "apple    pear banana  "
Dim testArray() As String = Split(testString)
' testArray holds {"apple", "", "", "", "pear", "banana", "", ""}
Dim lastNonEmpty As Integer = -1
For i As Integer = 0 To testArray.Length - 1
    If testArray(i) <> "" Then
        lastNonEmpty += 1
        testArray(lastNonEmpty) = testArray(i)
    End If
Next
ReDim Preserve testArray(lastNonEmpty)
' testArray now holds {"apple", "pear", "banana"}

Commenti

Per impostazione predefinita, o quando Limit è uguale a -1, la Split funzione divide la stringa di input in ogni occorrenza della stringa del delimitatore e restituisce le sottostringhe in una matrice. Quando il Limit parametro è maggiore di zero, la Split funzione divide la stringa nelle prime Limit-1 occorrenze del delimitatore e restituisce una matrice con le sottostringhe risultanti. Ad esempio, restituisce Split("a:b:c", ":") la matrice {"a", "b", "c"}, mentre Split("a:b:c", ":", 2) restituisce la matrice {"a", "b:c"}.

Quando la Split funzione rileva due delimitatori in una riga o un delimitatore all'inizio o alla fine della stringa, li interpreta come circostante una stringa vuota (""). Ad esempio, Split("xx", "x") restituisce la matrice contenente tre stringhe vuote: una tra l'inizio della stringa e la prima "x", una tra le due stringhe "x" e una tra l'ultima "x" e la fine della stringa.

Questa tabella illustra come i parametri facoltativi Delimiter, Limite Compare possono modificare il comportamento della Split funzione.

Split Call Valore restituito
Split("42, 12, 19") {"42," , "12," , "19"}
Split("42, 12, 19", ", ") {"42", "12", "19"}
Split("42, 12, 19", ", ", 2) {"42", "12, 19"}
Split("192.168.0.1", ".") {"192", "168", "0", "1"}
Split("Alice and Bob", " AND ") {"Alice e Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text) {"Alice", "Bob"}
Split("someone@example.com", "@",1) {"someone@example.com"}
Split("someone@example.com", "@",2) {"someone", "example.com"}

L'argomento Compare può avere i valori seguenti.

Costante Description Value
CompareMethod.Binary Esegue un confronto binario 0
CompareMethod.Text Esegue un confronto testuale 1

Si applica a

Vedi anche