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

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 à

Partager via