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

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.dll

Devuelve una matriz unidimensional basada en cero que contiene un número especificado de subcadenas.

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

Expression
String

Required. String expresión que contiene subcadenas y delimitadores.

Delimiter
String

Optional. Cualquier carácter único usado para identificar los límites de subcadena. Si Delimiter se omite, se supone que el carácter de espacio (" ") es el delimitador.

Limit
Int32

Optional. Número máximo de subcadenas en las que se debe dividir la cadena de entrada. El valor predeterminado, -1, indica que la cadena de entrada debe dividirse en cada aparición de la Delimiter cadena.

Compare
CompareMethod

Optional. Valor numérico que indica la comparación que se va a usar al evaluar subcadenas. Consulte "Configuración" para ver los valores.

Devoluciones

String[]

Matriz de tipoString . Si Expression es una cadena de longitud cero (""), Split devuelve una matriz de un solo elemento que contiene una cadena de longitud cero. Si Delimiter es una cadena de longitud cero o si no aparece en ningún lugar de Expression, Split devuelve una matriz de un solo elemento que contiene toda Expression la cadena.

Ejemplos

En el ejemplo siguiente se muestra cómo dividir una cadena en sus espacios.

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

En el ejemplo siguiente se muestra cómo dividir cadenas con varios delimitadores en una fila y filtrar las cadenas vacías.

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

Comentarios

De forma predeterminada, o cuando Limit es igual a -1, la Split función divide la cadena de entrada en cada aparición de la cadena delimitador y devuelve las subcadenas de una matriz. Cuando el Limit parámetro es mayor que cero, la Split función divide la cadena en las primeras Limitrepeticiones -1 del delimitador y devuelve una matriz con las subcadenas resultantes. Por ejemplo, Split("a:b:c", ":") devuelve la matriz {"a", "b", "c"}, mientras Split("a:b:c", ":", 2) que devuelve la matriz {"a", "b:c"}.

Cuando la Split función encuentra dos delimitadores en una fila o un delimitador al principio o al final de la cadena, los interpreta como rodeando una cadena vacía (""). Por ejemplo, Split("xx", "x") devuelve la matriz que contiene tres cadenas vacías: una de entre el principio de la cadena y la primera "x", una de entre las dos cadenas "x" y otra de entre la última "x" y el final de la cadena.

En esta tabla se muestra cómo los parámetros opcionales Delimiter, Limity Compare pueden cambiar el comportamiento de la Split función.

Llamada dividida Valor devuelto
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 y Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text) {"Alice", "Bob"}
Split("someone@example.com", "@",1) {""someone@example.com}
Split("someone@example.com", "@",2) {"alguien", "example.com"}

El Compare argumento puede tener los valores siguientes.

Constante Descripción Value
CompareMethod.Binary Realiza una comparación binaria 0
CompareMethod.Text Realiza una comparación de texto 1

Se aplica a

Consulte también