Strings.Split(String, String, Int32, CompareMethod) Método

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

Parâmetros

Retornos

Matriz String. Se Expression for uma cadeia de caracteres de comprimento zero (""), Split retornará uma matriz de elemento único contendo uma cadeia de caracteres de comprimento zero. Se Delimiter for uma cadeia de caracteres de comprimento zero ou se ela não aparecer em Expressionnenhum lugar, Split retornará uma matriz de elemento único que contém toda a cadeia de caracteres Expression .

Exemplos

O exemplo a seguir demonstra como dividir uma cadeia de caracteres em seus espaços.

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

O exemplo a seguir demonstra como dividir cadeias de caracteres com vários delimitadores em uma linha e filtrar as cadeias de caracteres vazias.

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

Comentários

Por padrão, ou quando Limit igual a -1, a Split função divide a cadeia de caracteres de entrada em cada ocorrência da cadeia de caracteres delimitador e retorna as subcadeias de caracteres em uma matriz. Quando o Limit parâmetro é maior que zero, a Split função divide a cadeia de caracteres nas primeiras Limit-1 ocorrências do delimitador e retorna uma matriz com as subcadeias de caracteres resultantes. Por exemplo, Split("a:b:c", ":") retorna a matriz {"a", "b", "c"}, enquanto Split("a:b:c", ":", 2) retorna a matriz {"a", "b:c"}.

Quando a Split função encontra dois delimitadores em uma linha ou um delimitador no início ou no final da cadeia de caracteres, ela os interpreta como cercando uma cadeia de caracteres vazia (""). Por exemplo, Split("xx", "x") retorna a matriz que contém três cadeias de caracteres vazias: uma entre o início da cadeia de caracteres e a primeira "x", uma entre as duas cadeias de caracteres "x" e outra entre o último "x" e o final da cadeia de caracteres.

Esta tabela demonstra como os parâmetros opcionais e Compare opcionais DelimiterLimitpodem alterar o comportamento da Split função.

O Compare argumento pode ter os seguintes valores.

Confira também

• Join
• CompareMethod
• Resumo da manipulação de cadeia de caracteres