Strings.Split(String, String, Int32, CompareMethod) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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-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 |