Partager via


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

Définition

Retourne un tableau à une dimension de base zéro et contenant le nombre spécifié de sous-chaînes.

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

Expression
String

Obligatoire. Expression String contenant des sous-chaînes et des délimiteurs.

Delimiter
String

Optionnel. Tout caractère utilisé pour identifier les limites des sous-chaînes. Si Delimiter est omis, le caractère espace (" ") est utilisé par défaut comme délimiteur.

Limit
Int32

Optionnel. Nombre maximal de sous-chaînes à obtenir après fractionnement de la chaîne d'entrée. La valeur par défaut, -1, indique que la chaîne d’entrée doit être fractionnée à chaque occurrence de la chaîne Delimiter.

Compare
CompareMethod

Optionnel. Valeur numérique indiquant la comparaison à utiliser pour l'évaluation des sous-chaînes. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

Retours

String[]

TableauString . Si Expression est une chaîne de longueur nulle (""), Split retourne un tableau à un seul élément qui contient une chaîne de longueur nulle. Si Delimiter est une chaîne de longueur nulle, ou s'il n'apparaît nulle part dans Expression, Split retourne un tableau à un seul élément qui contient la chaîne Expression dans son intégralité.

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 quand Limit est égal à -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 aux premières Limitoccurrences -1 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) retourne le tableau {"a", "b:c"}.

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, elle les interprète comme entourant une chaîne vide («  »). Par exemple, Split("xx", "x") retourne le tableau contenant trois chaînes vides : une à partir du début de la chaîne et du premier « x », une entre les deux chaînes « x » et une entre la dernière chaîne « x » et la fin de la chaîne.

Ce tableau montre comment les paramètres facultatifs Delimiter, Limitet Compare peuvent modifier le comportement de la Split fonction.

Appel fractionné Valeur de retour
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"}

L’argument Compare peut avoir les valeurs suivantes.

Constant Description Valeur
CompareMethod.Binary Effectue une comparaison binaire 0
CompareMethod.Text Effectue une comparaison de texte 1

S’applique à

Voir aussi