Função Split (Visual Basic)

Artigo
08/25/2010

Retorna um matriz unidimensional baseada em zero, contendo um número especificado de substrings.

Function Split(
   ByVal Expression As String,
   Optional ByVal Delimiter As String = " ",
   Optional ByVal Limit As Integer = -1,
   Optional ByVal Compare As CompareMethod = CompareMethod.Binary
) As String()

Parâmetros

Expression
Obrigatório.String expressão contendo substrings e delimitadores.
Delimiter
Opcional.Qualquer caractere singular usado para identificar limites subsequência de caracteres.Se Delimiter for omitido, o caractere de espaço (" ") é assumido como o delimitador.
Limit
Opcional.Número máximo de substrings no qual a sequência de caracteres de entrada deve ser dividida.O padrão, – 1, indica que a sequência de caracteres de entrada deve ser dividida em cada ocorrência da sequência Delimiter.
Compare
Opcional.Valor numérico indicando a comparação para usar ao avaliar substrings.Consulte "Configurações" para os valores.

Retornos

String MATRIZ.Se Expression é uma cadeia de caracteres de comprimento zero (" "), Split retorna uma matriz de elemento único que contém uma cadeia de caracteres de comprimento zero.Se Delimiter é uma cadeia de comprimento nulo, ou se ele não aparecer em qualquer lugar no Expression, Split retorna uma matriz de elemento único que contém a sequência Expression inteira.

Configurações

O argumento Compare pode ter os seguintes valores.

Constante	Descrição	Valor
CompareMethod.Binary	Executa uma comparação binária.	0
CompareMethod.Text	Executa uma comparação textual	1

Comentários

Por padrão, ou quando Limit é igual a-1, a função Split divide a sequência de entrada em cada ocorrência da sequência delimitadora e retorna as substring numa matriz.Quando o parâmetro Limit é maior que zero, a função Split divide a sequência de caracteres nas primeira ocorrências Limit -1 do delimitador e retorna uma matriz com os substrings 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 função Split encontra dois delimitadores em uma linha, ou um delimitador no início ou fim da sequência de caracteres, ele interpreta como envolvem uma sequência de caracteres vazia (" ").Por exemplo, Split("xx", "x") Retorna a matriz que contém três cadeias de caracteres vazias: um de entre o início da seqüência de caracteres de e o primeiro "x", um de entre duas "seqüências de caracteres x" e um de entre o último "x" e o participante da seqüência de caracteres.

Esta tabela mostra como o Delimiter opcional, Limit,e os parâmetros Compare podem alterar o comportamento da função Split.

Chamada de divisão	Valor de retorno
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 and Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text)	{"Alice", "Bob"}
Split("someone@example.com", "@",1)	{"someone@example.com"}
Split("someone@example.com", "@",2)	{"someone", "example.com"}

Exemplo

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 sequências de caracteres com vários delimitadores em uma linha e filtrar as sequências 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"}