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

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll

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);
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 seinen 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 geteilt und die leeren Zeichenfolgen gefiltert 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 die Funktion 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 null ist, teilt die Split Funktion die Zeichenfolge bei den ersten Limit-1 Vorkommen des Trennzeichens und gibt ein Array mit den resultierenden Teilzeichenfolgen zurück. Gibt beispielsweise Split("a:b:c", ":") das Array {"a", "b", "c"}zurück, während Split("a:b:c", ":", 2) das Array {"a", "b:c"}zurückgegeben wird.

Wenn die Split Funktion zwei Trennzeichen in einer Zeile oder ein Trennzeichen am Anfang oder Ende der Zeichenfolge erkennt, interpretiert sie sie als leere Zeichenfolge (""). Gibt beispielsweise das Array zurück, Split("xx", "x") das drei leere Zeichenfolgen enthält: eine zwischen dem Anfang der Zeichenfolge und dem ersten "x", einer von den beiden "x"-Zeichenfolgen und einer zwischen den letzten "x" und dem Ende der Zeichenfolge.

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

Geteilter Anruf 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

Gilt für

Siehe auch