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

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Strings.vb

Zwraca opartą na zeru, jednowymiarową tablicę zawierającą określoną liczbę podciągów.

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()

Parametry

Expression

String

Required. String wyrażenie zawierające podciągi i ograniczniki.

Delimiter

String

Optional. Dowolny pojedynczy znak używany do identyfikowania limitów podciągów. Jeśli Delimiter zostanie pominięty, przyjmuje się, że znak spacji (" ") jest ogranicznikiem.

Limit

Int32

Optional. Maksymalna liczba podciągów, w których należy podzielić ciąg wejściowy. Wartość domyślna -1 wskazuje, że ciąg wejściowy powinien być podzielony w każdym wystąpieniu Delimiter ciągu.

Compare

CompareMethod

Optional. Wartość liczbowa wskazująca porównanie używane podczas oceniania podciągów. Zobacz "Ustawienia" dla wartości.

Zwraca

String[]

String tablica. Jeśli Expression jest ciągiem o zerowej długości (""), Split zwraca tablicę z jednym elementem zawierającą ciąg o zerowej długości. Jeśli Delimiter jest ciągiem o zerowej długości lub jeśli nie pojawia się nigdzie w elemecie Expression, Split zwraca tablicę z jednym elementem zawierającą cały Expression ciąg.

Przykłady

W poniższym przykładzie pokazano, jak podzielić ciąg na jego spacje.

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

W poniższym przykładzie pokazano, jak podzielić ciągi z wieloma ogranicznikami w wierszu i odfiltrować puste ciągi.

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"}

Uwagi

Domyślnie lub gdy Limit równa -1, Split funkcja dzieli ciąg wejściowy w każdym wystąpieniu ciągu ogranicznika i zwraca podciągi w tablicy. Limit Gdy parametr jest większy niż zero, Split funkcja dzieli ciąg na pierwsze Limit-1 wystąpienia ogranicznika i zwraca tablicę z wynikowymi podciągami. Na przykład zwraca tablicę Split("a:b:c", ":"), a funkcja {"a", "b", "c"} zwraca tablicę Split("a:b:c", ":", 2). {"a", "b:c"}

Split Gdy funkcja napotka dwa ograniczniki w wierszu lub ogranicznik na początku lub na końcu ciągu, interpretuje je jako otaczające pusty ciąg (""). Na przykład Split("xx", "x") zwraca tablicę zawierającą trzy puste ciągi: jedną od początku ciągu i pierwszą "x", jedną między dwoma ciągami "x" i jedną z między ostatnim "x" a końcem ciągu.

W tej tabeli pokazano, jak opcjonalne Delimiterparametry , Limiti Compare mogą zmieniać zachowanie Split funkcji.

Podziel połączenie	Wartość zwracana
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 i Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text)	{"Alice", "Bob"}
Split("someone@example.com", "@",1)	{""someone@example.com}
Split("someone@example.com", "@",2)	{"ktoś", "example.com"}

Argument Compare może mieć następujące wartości.

Stała	Opis	Wartość
CompareMethod.Binary	Wykonuje porównanie binarne	0
CompareMethod.Text	Wykonuje porównanie tekstowe	1

Zobacz też

• Join
• CompareMethod
• Podsumowanie manipulowania ciągami