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

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ètres

Retours

TableauString . S’il s’agit Expression d’une chaîne de longueur nulle («  »), Split retourne un tableau à élément unique contenant une chaîne de longueur nulle. S’il Delimiter s’agit d’une chaîne de longueur nulle, ou s’il n’apparaît nulle part dans Expression, Split retourne un tableau à élément unique contenant la chaîne entière Expression .

Exemples

L’exemple suivant montre comment fractionner une chaîne à ses espaces.

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

L’exemple suivant montre comment fractionner des chaînes avec plusieurs délimiteurs dans une ligne et filtrer les chaînes vides.

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

Remarques

Par défaut, ou lorsqu’elle Limit est égale à -1, la Split fonction fractionne la chaîne d’entrée à chaque occurrence de la chaîne de délimiteur et retourne les sous-chaînes dans un tableau. Lorsque le Limit paramètre est supérieur à zéro, la Split fonction fractionne la chaîne au premier Limit-1 occurrences du délimiteur et retourne un tableau avec les sous-chaînes résultantes. Par exemple, Split("a:b:c", ":") retourne le tableau {"a", "b", "c"}, tandis que Split("a:b:c", ":", 2) le tableau {"a", "b:c"}est retourné.

Lorsque la Split fonction rencontre deux délimiteurs dans une ligne ou un délimiteur au début ou à la fin de la chaîne, il les interprète comme entourant une chaîne vide ( » « ). Par exemple, Split("xx", "x") retourne le tableau contenant trois chaînes vides : une entre le début de la chaîne et le premier « x », un entre les deux chaînes « x », et l’autre entre le dernier « x » et la fin de la chaîne.

Ce tableau montre comment les paramètres facultatifs Delimiteret Limit facultatifs Comparepeuvent modifier le comportement de la Split fonction.

L’argument Compare peut avoir les valeurs suivantes.

Voir aussi

• Join
• CompareMethod
• Résumé de la manipulation de chaînes