Strings.Filter Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Surcharges

Filter(Object[], String, Boolean, CompareMethod)	Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.
Filter(String[], String, Boolean, CompareMethod)	Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Filter(Object[], String, Boolean, CompareMethod)

Source:

Strings.vb

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

public static string[]? Filter (object?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Filter : obj[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]

Public Function Filter (Source As Object(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Paramètres

Source

Object[]

Obligatoire. Tableau unidimensionnel de chaînes dans lequel la recherche doit être effectuée.

Match

String

Obligatoire. Chaîne à rechercher.

Include

Boolean

Optionnel. Valeur Boolean qui indique s'il faut retourner les sous-chaînes incluant ou excluant Match. Si Include a la valeur True, la fonction Filter retourne le sous-ensemble du tableau contenant Match comme sous-chaîne. Si Include a la valeur False, la fonction Filter retourne le sous-ensemble du tableau ne contenant pas Match comme sous-chaîne.

Compare

CompareMethod

Optionnel. Valeur numérique indiquant le type de comparaison de chaîne à utiliser. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

Retours

String[]

Un tableau de base zéro et contenant un sous-ensemble d’un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Exceptions

ArgumentException

Source a la valeur Nothing ou n'est pas un tableau unidimensionnel.

Exemples

Cet exemple illustre l’utilisation de la Filter fonction .

Dim testStrings(2) As String
testStrings(0) = "This"
testStrings(1) = "Is"
testStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(testStrings, "is", False, CompareMethod.Binary)

Remarques

Si aucune correspondance de n’est Match trouvée dans Source, la Filter fonction retourne un tableau vide. Une erreur se produit si Source est défini sur Nothing ou n’est pas un tableau unidimensionnel.

Le tableau retourné par la Filter fonction contient uniquement suffisamment d’éléments pour contenir le nombre d’éléments correspondants.

L’argument Compare peut avoir les valeurs suivantes.

Constant	Description
CompareMethod.Binary	Effectue une comparaison binaire
CompareMethod.Text	Effectue une comparaison textuelle

Voir aussi

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Liste des manipulations de chaînes

Filter(String[], String, Boolean, CompareMethod)

Source:

Strings.vb

Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

public static string[]? Filter (string?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Filter : string[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]

Public Function Filter (Source As String(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Paramètres

Source

String[]

Obligatoire. Tableau unidimensionnel de chaînes dans lequel la recherche doit être effectuée.

Match

String

Obligatoire. Chaîne à rechercher.

Include

Boolean

Optionnel. Valeur Boolean qui indique s'il faut retourner les sous-chaînes incluant ou excluant Match. Si Include a la valeur True, la fonction Filter retourne le sous-ensemble du tableau contenant Match comme sous-chaîne. Si Include a la valeur False, la fonction Filter retourne le sous-ensemble du tableau ne contenant pas Match comme sous-chaîne.

Compare

CompareMethod

Optionnel. Valeur numérique indiquant le type de comparaison de chaîne à utiliser. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

Retours

String[]

Un tableau de base zéro et contenant un sous-ensemble d’un tableau de chaînes (String) basé sur des critères de filtre spécifiés.

Exceptions

ArgumentException

Source a la valeur Nothing ou n'est pas un tableau unidimensionnel.

Exemples

Cet exemple illustre l’utilisation de la Filter fonction .

Dim testStrings(2) As String
testStrings(0) = "This"
testStrings(1) = "Is"
testStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(testStrings, "is", False, CompareMethod.Binary)

Remarques

Si aucune correspondance de n’est Match trouvée dans Source, la Filter fonction retourne un tableau vide. Une erreur se produit si Source est défini sur Nothing ou n’est pas un tableau unidimensionnel.

Le tableau retourné par la Filter fonction contient uniquement suffisamment d’éléments pour contenir le nombre d’éléments correspondants.

L’argument Compare peut avoir les valeurs suivantes.

Constant	Description
CompareMethod.Binary	Effectue une comparaison binaire
CompareMethod.Text	Effectue une comparaison textuelle

Voir aussi

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Liste des manipulations de chaînes