Strings.Split(String, String, Int32, CompareMethod) Strings.Split(String, String, Int32, CompareMethod) Strings.Split(String, String, Int32, CompareMethod) Method

Definición

Devuelve una matriz unidimensional basada en cero que contiene un número especificado de subcadenas.Returns a zero-based, one-dimensional array containing a specified number of substrings.

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 String String

Obligatorio.Required. Expresión de tipo String que contiene subcadenas y delimitadores.String expression containing substrings and delimiters.

Delimiter
String String String

Opcional.Optional. Cualquier carácter individual que se utilice para identificar los límites de las subcadenas.Any single character used to identify substring limits. Si se omite Delimiter, se supone que el carácter de espacio (" ") es el delimitador.If Delimiter is omitted, the space character (" ") is assumed to be the delimiter.

Limit
Int32 Int32 Int32

Opcional.Optional. Número máximo de subcadenas en las que se debe dividir la cadena de entrada.Maximum number of substrings into which the input string should be split. El valor predeterminado es -1, que indica que la cadena de entrada se debe dividir cada vez que aparece la cadena Delimiter.The default, -1, indicates that the input string should be split at every occurrence of the Delimiter string.

Compare
CompareMethod CompareMethod CompareMethod

Opcional.Optional. Valor numérico que indica la comparación que se va a utilizar al evaluar subcadenas.Numeric value indicating the comparison to use when evaluating substrings. Consulte los valores en "Configuración".See "Settings" for values.

Devoluciones

String[]

Matriz de tipoString .String array. Si Expression es una cadena de longitud cero (""), Split devuelve una matriz de un solo elemento que contiene una cadena de longitud cero.If Expression is a zero-length string (""), Split returns a single-element array containing a zero-length string. Si Delimiter es una cadena de longitud cero o si no aparece en Expression, Split devuelve una matriz de un solo elemento que contiene toda la cadena Expression.If Delimiter is a zero-length string, or if it does not appear anywhere in Expression, Split returns a single-element array containing the entire Expression string.

Ejemplos

En el ejemplo siguiente se muestra cómo dividir una cadena en sus espacios.The following example demonstrates how to split a string at its spaces.

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.The following example demonstrates how to split strings with multiple delimiters in a row and filter out the empty strings.

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 Limit cuando es igual a-1 Split , la función divide la cadena de entrada en cada aparición de la cadena delimitadora y devuelve las subcadenas de una matriz.By default, or when Limit equals -1, the Split function splits the input string at every occurrence of the delimiter string, and returns the substrings in an array. Cuando el Limit parámetro es mayor que cero, la Split función divide la cadena en las primeras Limit1 apariciones del delimitador y devuelve una matriz con las subcadenas resultantes.When the Limit parameter is greater than zero, the Split function splits the string at the first Limit-1 occurrences of the delimiter, and returns an array with the resulting substrings. Por ejemplo, Split("a:b:c", ":") devuelve la matriz {"a", "b", "c"}, mientras Split("a:b:c", ":", 2) que devuelve la {"a", "b:c"}matriz.For example, Split("a:b:c", ":") returns the array {"a", "b", "c"}, while Split("a:b:c", ":", 2) returns the array {"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 una cadena vacía ("").When the Split function encounters two delimiters in a row, or a delimiter at the beginning or end of the string, it interprets them as surrounding an empty string (""). Por ejemplo, Split("xx", "x") devuelve la matriz que contiene tres cadenas vacías: una entre el principio de la cadena y la primera "x", una entre las dos cadenas "x" y otra entre la última "x" y el final de la cadena.For example, Split("xx", "x") returns the array containing three empty strings: one from between the beginning of the string and the first "x", one from between the two "x" strings, and one from between the last "x" and the end of the string.

En esta tabla se muestra cómo Delimiterlos Limitparámetros opcionales Compare , y pueden cambiar el comportamiento de Split la función.This table demonstrates how the optional Delimiter, Limit, and Compare parameters can change the behavior of the Split function.

Llamada de divisiónSplit Call Valor devueltoReturn Value
Split("42, 12, 19") {"42," , "12," , "19"}{"42," , "12," , "19"}
Split("42, 12, 19", ", ") {"42", "12", "19"}{"42", "12", "19"}
Split("42, 12, 19", ", ", 2) {"42", "12, 19"}{"42", "12, 19"}
Split("192.168.0.1", ".") {"192", "168", "0", "1"}{"192", "168", "0", "1"}
Split("Alice and Bob", " AND ") {"Alice y Bob"}{"Alice and Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text) {"Alice", "Bob"}{"Alice", "Bob"}
Split("someone@example.com", "@",1) {"someone@example.com"}{"someone@example.com"}
Split("someone@example.com", "@",2) {"alguien", "example.com"}{"someone", "example.com"}

El Compare argumento puede tener los valores siguientes.The Compare argument can have the following values.

ConstanteConstant DescripciónDescription ValorValue
CompareMethod.Binary Realiza una comparación binariaPerforms a binary comparison 00
CompareMethod.Text Realiza una comparación textualPerforms a textual comparison 11

Se aplica a

Consulte también: