Sdílet prostřednictvím


Strings.Filter Metoda

Definice

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
Zdroj:
Strings.vb
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);
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

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é

Platí pro

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

Zdroj:
Strings.vb
Zdroj:
Strings.vb
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);
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

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é

Platí pro