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

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

Restituisce una matrice unidimensionale con indice in base zero che contiene il numero di sottostringhe specificato.

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

Obbligatorio. Espressione String contenente sottostringhe e delimitatori.

Delimiter

String

facoltativo. Qualsiasi carattere singolo utilizzato per identificare i limiti delle sottostringhe. Se Delimiter viene omesso, come delimitatore viene utilizzato il carattere spazio (" ").

Limit

Int32

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

Compare

CompareMethod

facoltativo. Valore numerico che indica il tipo di confronto da utilizzare per la valutazione delle sottostringhe. Per un elenco dei valori possibili, vedere "Impostazioni".

Restituisce

String[]

Matrice String. Se Expression è una stringa di lunghezza zero (""), Split restituisce una matrice costituita da un solo elemento contenente una stringa di lunghezza zero. Se Delimiter è una stringa di lunghezza zero, oppure se non compare mai nella stringa Expression, Split restituisce una matrice con un solo elemento contenente l'intera stringa Expression.

Esempio

Nell'esempio seguente viene illustrato come dividere 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, Split("a:b:c", ":") restituisce 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)	{"qualcuno", "example.com"}

L'argomento Compare può avere i valori seguenti.

Costante	Descrizione	Valore
CompareMethod.Binary	Esegue un confronto binario	0
CompareMethod.Text	Esegue un confronto testuale	1

Vedi anche

• Join
• CompareMethod
• Riepilogo della modifica delle stringhe