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

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

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);

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

Voir aussi

• Join
• CompareMethod
• Liste des manipulations de chaînes