Strings.Filter Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Vrátí matici založenou na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.

Přetížení

Filter(Object[], String, Boolean, CompareMethod)	Vrátí matici založenou na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.
Filter(String[], String, Boolean, CompareMethod)	Vrátí matici založenou na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.

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

Zdroj:

Strings.vb

Vrátí matici založenou na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.

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

Parametry

Source

Object[]

Povinná hodnota. Jednorozměrné pole řetězců, které mají být prohledány.

Match

String

Povinná hodnota. Řetězec, který chcete vyhledat.

Include

Boolean

Nepovinný parametr. Boolean hodnota označující, zda se mají vrátit podřetětěce, které zahrnují nebo vylučují Match. Pokud Include je True, Filter vrátí funkce podmnožinu pole, která obsahuje Match jako podřetěc. Pokud Include je False, Filter vrátí funkce podmnožinu pole, která neobsahuje Match jako podřetěc.

Compare

CompareMethod

Nepovinný parametr. Číselná hodnota označující druh porovnání řetězců, který se má použít. Hodnoty naleznete v části „Nastavení“.

Návraty

String[]

Matice založená na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.

Výjimky

ArgumentException

Source je Nothing nebo není jednorozměrné pole.

Příklady

Tento příklad ukazuje použití Filter funkce .

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)

Poznámky

Pokud nejsou nalezeny Match žádné shody v Source, Filter vrátí funkce prázdné pole. K chybě dojde, pokud Source je nastavena na Nothing nebo není jednorozměrné pole.

Pole vrácené Filter funkcí obsahuje pouze dostatek prvků, které obsahují počet odpovídajících položek.

Argument Compare může mít následující hodnoty.

Konstanta	Description
CompareMethod.Binary	Provádí binární porovnání.
CompareMethod.Text	Provádí textové porovnání.

Viz také

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Souhrn manipulace s řetězci

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

Zdroj:

Strings.vb

Vrátí matici založenou na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.

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

Parametry

Source

String[]

Povinná hodnota. Jednorozměrné pole řetězců, které mají být prohledány.

Match

String

Povinná hodnota. Řetězec, který chcete vyhledat.

Include

Boolean

Nepovinný parametr. Boolean hodnota označující, zda se mají vrátit podřetětěce, které zahrnují nebo vylučují Match. Pokud Include je True, Filter vrátí funkce podmnožinu pole, která obsahuje Match jako podřetěc. Pokud Include je False, Filter vrátí funkce podmnožinu pole, která neobsahuje Match jako podřetěc.

Compare

CompareMethod

Nepovinný parametr. Číselná hodnota označující druh porovnání řetězců, který se má použít. Hodnoty naleznete v části „Nastavení“.

Návraty

String[]

Matice založená na nule obsahující podmnožinu String pole na základě zadaných kritérií filtru.

Výjimky

ArgumentException

Source je Nothing nebo není jednorozměrné pole.

Příklady

Tento příklad ukazuje použití Filter funkce .

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)

Poznámky

Pokud nejsou nalezeny Match žádné shody v Source, Filter vrátí funkce prázdné pole. K chybě dojde, pokud Source je nastavena na Nothing nebo není jednorozměrné pole.

Pole vrácené Filter funkcí obsahuje pouze dostatek prvků, které obsahují počet odpovídajících položek.

Argument Compare může mít následující hodnoty.

Konstanta	Description
CompareMethod.Binary	Provádí binární porovnání.
CompareMethod.Text	Provádí textové porovnání.

Viz také

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Souhrn manipulace s řetězci