Strings.Filter Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

Przeciążenia

Filter(Object[], String, Boolean, CompareMethod)	Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy na podstawie określonych kryteriów filtrowania.
Filter(String[], String, Boolean, CompareMethod)	Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

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

Źródło:

Strings.vb

Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

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[]

Wymagane. Jednowymiarowa tablica ciągów do przeszukania.

Match

String

Wymagane. Ciąg do wyszukania.

Include

Boolean

Opcjonalny. Boolean wartość wskazująca, czy zwracać podciągy, które zawierają, czy wykluczają Match. Jeśli Include parametr ma Truewartość , Filter funkcja zwraca podzbiór tablicy zawierającej Match jako podciąg. Jeśli Include parametr ma Falsewartość , Filter funkcja zwraca podzbiór tablicy, która nie zawiera Match jako podciąg.

Compare

CompareMethod

Opcjonalny. Wartość liczbowa wskazująca rodzaj porównania ciągów do użycia. W przypadku wartości zobacz sekcję „Ustawienia".

Zwraca

String[]

Tablica oparta na zerze zawierająca podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

Wyjątki

ArgumentException

Source jest Nothing tablicą jednowymiarową lub nie jest.

Przykłady

W tym przykładzie pokazano użycie Filter funkcji .

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)

Uwagi

Jeśli w programie Sourcenie znaleziono dopasowań Match elementu , Filter funkcja zwraca pustą tablicę. Błąd występuje, jeśli Source jest ustawiona na Nothing lub nie jest tablicą jednowymiarową.

Tablica zwracana przez Filter funkcję zawiera tylko tyle elementów, aby zawierały liczbę dopasowanych elementów.

Argument Compare może mieć następujące wartości.

Stała	Opis
CompareMethod.Binary	Wykonuje porównanie binarne
CompareMethod.Text	Wykonuje porównanie tekstowe

Zobacz też

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Manipulowanie ciągami — podsumowanie

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

Źródło:

Strings.vb

Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

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[]

Wymagane. Jednowymiarowa tablica ciągów do przeszukania.

Match

String

Wymagane. Ciąg do wyszukania.

Include

Boolean

Opcjonalny. Boolean wartość wskazująca, czy zwracać podciągy, które zawierają, czy wykluczają Match. Jeśli Include parametr ma Truewartość , Filter funkcja zwraca podzbiór tablicy zawierającej Match jako podciąg. Jeśli Include parametr ma Falsewartość , Filter funkcja zwraca podzbiór tablicy, która nie zawiera Match jako podciąg.

Compare

CompareMethod

Opcjonalny. Wartość liczbowa wskazująca rodzaj porównania ciągów do użycia. W przypadku wartości zobacz sekcję „Ustawienia".

Zwraca

String[]

Tablica oparta na zerze zawierająca podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

Wyjątki

ArgumentException

Source jest Nothing tablicą jednowymiarową lub nie jest.

Przykłady

W tym przykładzie pokazano użycie Filter funkcji .

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)

Uwagi

Jeśli w programie Sourcenie znaleziono dopasowań Match elementu , Filter funkcja zwraca pustą tablicę. Błąd występuje, jeśli Source jest ustawiona na Nothing lub nie jest tablicą jednowymiarową.

Tablica zwracana przez Filter funkcję zawiera tylko tyle elementów, aby zawierały liczbę dopasowanych elementów.

Argument Compare może mieć następujące wartości.

Stała	Opis
CompareMethod.Binary	Wykonuje porównanie binarne
CompareMethod.Text	Wykonuje porównanie tekstowe

Zobacz też

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Manipulowanie ciągami — podsumowanie