Strings.Split(String, String, Int32, CompareMethod) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Egy nulla alapú, egydimenziós tömböt ad vissza, amely megadott számú részsztringet tartalmaz.
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()
Paraméterek
- Expression
- String
Kötelező.
String sztringeket és elválasztójeleket tartalmazó kifejezés.
- Delimiter
- String
Optional. Minden olyan karakter, amely a részszűkítési korlátok azonosítására szolgál. Ha Delimiter nincs megadva, akkor a szóköz karakter (" ") lesz a határoló karakter.
- Limit
- Int32
Optional. Azon részsztringek maximális száma, amelyekbe a bemeneti sztringet fel kell osztani. Az alapértelmezett -1 azt jelzi, hogy a bemeneti sztringet a sztring minden előfordulásánál Delimiter fel kell osztani.
- Compare
- CompareMethod
Optional. Numerikus érték, amely az alsztringek kiértékelésekor használandó összehasonlítást jelzi. Az értékekről lásd a "Beállítások" című témakört.
Válaszok
String tömb. Ha Expression nulla hosszúságú sztring (""), Split egy nulla hosszúságú sztringet tartalmazó egyelemű tömböt ad vissza. Ha Delimiter nulla hosszúságú sztring, vagy ha nem jelenik meg sehol Expression, Split a teljes Expression sztringet tartalmazó egyelemes tömböt ad vissza.
Példák
Az alábbi példa bemutatja, hogyan oszthat fel sztringet a szóközökön.
Dim testString As String = "Look at these!"
' Returns an array containing "Look", "at", and "these!".
Dim testArray() As String = Split(testString)
Az alábbi példa bemutatja, hogyan oszthat fel sztringeket több elválasztójellel egy sorban, és hogyan szűrheti ki az üres sztringeket.
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"}
Megjegyzések
Alapértelmezés szerint, vagy ha Limit -1, a Split függvény felosztja a bemeneti sztringet az elválasztó sztring minden előfordulására, és visszaadja a tömbben lévő részsztringeket. Ha a Limit paraméter nagyobb, mint nulla, a Split függvény felosztja a sztringet a határoló első Limit-1 előfordulásakor, és egy tömböt ad vissza az eredményül kapott részsztringekkel. Például Split("a:b:c", ":") a tömböt {"a", "b", "c"}adja vissza, míg Split("a:b:c", ":", 2) a tömböt {"a", "b:c"}adja vissza.
Amikor a Split függvény két elválasztójelet talál egy sorban vagy egy elválasztójelet a sztring elején vagy végén, úgy értelmezi őket, mint egy üres sztringet (""). Például Split("xx", "x") három üres sztringet tartalmazó tömböt ad vissza: egyet a sztring elejétől az első "x"-től, egyet a két "x" sztringtől, egyet pedig az utolsó "x" és a sztring végétől.
Ez a táblázat bemutatja, hogy a választható Delimiter, Limités Compare paraméterek hogyan módosíthatják a függvény viselkedését Split .
| Hívás felosztása | Visszaadott érték |
|---|---|
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 és Bob"} |
Split("Alice and Bob", " AND ", ,CompareMethod.Text) |
{"Alice", "Bob"} |
Split("someone@example.com", "@",1) |
{"someone@example.com"} |
Split("someone@example.com", "@",2) |
{"valaki", "example.com"} |
Az Compare argumentum a következő értékekkel rendelkezhet.
| Állandó | Leírás | Érték |
|---|---|---|
CompareMethod.Binary |
Bináris összehasonlítást végez | 0 |
CompareMethod.Text |
Szöveges összehasonlítást végez | 1 |