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

Definition

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

Required. String Ausdruck, der Teilzeichenfolgen und Trennzeichen enthält.

Delimiter
String

Dies ist optional. Jedes einzelne Zeichen, das zum Identifizieren von Teilzeichenfolgengrenzwerten verwendet wird. Wenn Delimiter nicht angegeben wird, wird das Leerzeichen (" ") als Trennzeichen angenommen.

Limit
Int32

Dies ist optional. Maximale Anzahl von Teilzeichenfolgen, in die die Eingabezeichenfolge aufgeteilt werden soll. Der Standardwert -1 gibt an, dass die Eingabezeichenfolge bei jedem Vorkommen der Delimiter Zeichenfolge aufgeteilt werden soll.

Compare
CompareMethod

Dies ist optional. Numerischer Wert, der den Vergleich angibt, der beim Auswerten von Teilzeichenfolgen verwendet werden soll. Werte finden Sie unter "Einstellungen".

Gibt zurück

String[]

String-Array. Wenn Expression es sich um eine leere Zeichenfolge ("") handelt, Split wird ein Einelementarray zurückgegeben, das eine leere Zeichenfolge enthält. Wenn Delimiter es sich um eine leere Zeichenfolge handelt oder sie nicht an einer beliebigen Stelle Expressionangezeigt wird, Split wird ein Einelementarray zurückgegeben, das die gesamte Expression Zeichenfolge enthält.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine Zeichenfolge an 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)

Das folgende Beispiel veranschaulicht, wie Zeichenfolgen mit mehreren Trennzeichen in einer Zeile geteilt 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

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

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", eine zwischen den beiden "x"-Zeichenfolgen und eine zwischen dem 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 Description Value
CompareMethod.Binary Führt einen binären Vergleich aus 0
CompareMethod.Text Führt einen Textvergleich aus 1

Gilt für:

Weitere Informationen