Strings.Split, méthode

Article
08/21/2007

Retourne un tableau unidimensionnel de base zéro contenant un nombre spécifié de sous-chaînes.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Split ( _
    Expression As String, _
    <OptionalAttribute> Optional Delimiter As String = " ", _
    <OptionalAttribute> Optional Limit As Integer = -1, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As String()
'Utilisation
Dim Expression As String
Dim Delimiter As String
Dim Limit As Integer
Dim Compare As CompareMethod
Dim returnValue As String()

returnValue = Strings.Split(Expression, Delimiter, Limit, Compare)

public static string[] Split (
    string Expression,
    [OptionalAttribute] string Delimiter,
    [OptionalAttribute] int Limit,
    [OptionalAttribute] CompareMethod Compare
)

public:
static array<String^>^ Split (
    String^ Expression, 
    [OptionalAttribute] String^ Delimiter, 
    [OptionalAttribute] int Limit, 
    [OptionalAttribute] CompareMethod Compare
)

public static String[] Split (
    String Expression, 
    /** @attribute OptionalAttribute() */ String Delimiter, 
    /** @attribute OptionalAttribute() */ int Limit, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function Split (
    Expression : String, 
    Delimiter : String, 
    Limit : int, 
    Compare : CompareMethod
) : String[]

Paramètres

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

Delimiter
Facultatif. 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
Facultatif. 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
Facultatif. Valeur numérique indiquant la comparaison à utiliser pour l'évaluation des sous-chaînes. Consultez la section « Paramètres » pour obtenir les valeurs.

Valeur de retour

Tableau String. 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é.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Split, fonction (Visual Basic).

Par défaut, ou lorsque Limit est égal à -1, la fonction Split 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 paramètre Limit est supérieur à zéro, la fonction Split fractionne la chaîne aux premières occurrences de Limit-1 du délimiteur et retourne un tableau avec les sous-chaînes obtenues. 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 fonction Split 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 une chaîne vide ("") d'encadrement. Par exemple, Split("xx", "x") retourne un tableau contenant trois chaînes vides : une allant du début de la chaîne jusqu'au premier "x", une située entre les deux chaînes "x", et une allant du dernier "x" à la fin de la chaîne.

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

Appel de Split	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 prendre les valeurs suivantes :

Constante	Description	Valeur
CompareMethod.Binary	Effectue une comparaison binaire	0
CompareMethod.Text	Effectue une comparaison textuelle	1

Exemple

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 comportant plusieurs délimiteurs par ligne et éliminer les chaînes vides par filtrage.

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

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms

Autres ressources

Split, fonction (Visual Basic)
Liste des manipulations de chaînes
Join, fonction (Visual Basic)
CompareMethod, énumération

Partager via