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

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

Strings.vb

Gibt ein nullbasiertes, eindimensionales Array zurück, das eine angegebene Anzahl von Teilzeichenfolgen enthält.

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

Parameter

Expression

String

Erforderlich. String-Ausdruck mit untergeordneten Zeichenfolgen und Trennzeichen.

Delimiter

String

Dies ist optional. Jedes einzelne Zeichen, mit dem Grenzen von untergeordneten Zeichenfolgen gekennzeichnet werden. Wenn Delimiter nicht angegeben wird, wird als Trennzeichen das Leerzeichen (" ") angenommen.

Limit

Int32

Dies ist optional. Die maximale Anzahl von untergeordneten Zeichenfolgen, in die die Eingabezeichenfolge geteilt werden soll. Der Standardwert –1 gibt an, dass die Eingabezeichenfolge an jedem Vorkommen der Delimiter-Zeichenfolge getrennt werden soll.

Compare

CompareMethod

Dies ist optional. Numerischer Wert, der den Vergleich angibt, der für das Auswerten von untergeordneten Zeichenfolgen verwendet wird. Die Werte finden Sie unter „Einstellungen“.

Gibt zurück

String[]

String -Array. Wenn Expression eine Zeichenfolge ("") der Länge 0 (null) ist, gibt Split ein Array mit einem Element zurück, das eine Zeichenfolge der Länge 0 (null) enthält. Wenn Delimiter eine Zeichenfolge der Länge 0 (null) ist oder nicht in Expression vorkommt, gibt Split ein Array mit einem Element zurück, das die gesamte Expression-Zeichenfolge enthält.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine Zeichenfolge in ihren Leerzeichen aufgeteilt wird.

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

Im folgenden Beispiel wird veranschaulicht, wie Zeichenfolgen mit mehreren Trennzeichen in einer Zeile aufgeteilt und die leeren Zeichenfolgen herausgefiltert werden.

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

Hinweise

Standardmäßig oder wenn Limit gleich -1 ist, teilt die Split Funktion die Eingabezeichenfolge bei jedem Vorkommen der Trennzeichenzeichenfolge auf und gibt die Teilzeichenfolgen in einem Array zurück. Wenn der Limit Parameter größer als 0 (null) ist, teilt die Split Funktion die Zeichenfolge bei den ersten LimitVorkommen des Trennzeichens -1 auf und gibt ein Array mit den resultierenden Teilzeichenfolgen zurück. Gibt beispielsweise das Array {"a", "b", "c"}zurück, Split("a:b:c", ":") während Split("a:b:c", ":", 2) das Array {"a", "b:c"}zurückgibt.

Wenn die Split Funktion auf zwei Trennzeichen in einer Zeile oder ein Trennzeichen am Anfang oder Ende der Zeichenfolge trifft, interpretiert sie sie so, dass sie eine leere Zeichenfolge ("") umgibt. Gibt z. B. das Array mit Split("xx", "x") drei leeren Zeichenfolgen zurück: eine zwischen dem Anfang der Zeichenfolge und dem ersten "x", eine aus zwischen den beiden "x"-Zeichenfolgen und eine aus zwischen dem letzten "x" und dem Ende der Zeichenfolge.

In dieser Tabelle wird veranschaulicht, wie die optionalen DelimiterParameter , Limitund Compare das Verhalten der Split Funktion ändern können.

Teilen eines Anrufs	Rückgabewert
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 und Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text)	{"Alice", "Bob"}
Split("someone@example.com", "@",1)	{"someone@example.com"}
Split("someone@example.com", "@",2)	{"jemand", "example.com"}

Das Compare Argument kann die folgenden Werte aufweisen.

Konstante	BESCHREIBUNG	Wert
CompareMethod.Binary	Führt einen binären Vergleich aus.	0
CompareMethod.Text	Führt einen Textvergleich aus.	1

Weitere Informationen

• Join
• CompareMethod
• Zeichenfolgenbearbeitung: Zusammenfassung