Strings.Filter Метод

Определение

Возвращает массив (с индексацией от нуля), который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

Перегрузки

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

Возвращает массив (с индексацией от нуля), который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

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

Возвращает массив (с индексацией от нуля), который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

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

Возвращает массив (с индексацией от нуля), который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

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

Параметры

Source
Object[]

Обязательный.Required. Одномерный массив строк, в котором необходимо выполнить поиск.One-dimensional array of strings to be searched.

Match
String

Обязательный.Required. Строка, которую требуется найти.String to search for.

Include
Boolean

Необязательный параметр.Optional. Значение типа Boolean, указывающее, какие подстроки требуется возвращать: содержащие или не содержащие строку Match.Boolean value indicating whether to return substrings that include or exclude Match. Если параметр Include равен True, функция Filter возвращает подмножество строк массива, содержащих Match в виде подстроки.If Include is True, the Filter function returns the subset of the array that contains Match as a substring. Если параметр Include равен False, функция Filter возвращает подмножество строк массива, не содержащих Match в виде подстроки.If Include is False, the Filter function returns the subset of the array that does not contain Match as a substring.

Compare
CompareMethod

Необязательный параметр.Optional. Числовое значение, указывающее вид выполняемого сравнения строк.Numeric value indicating the kind of string comparison to use. Сведения о значениях см. в разделе "Параметры".See "Settings" for values.

Возвраты

String[]

Массив с индексацией от нуля, который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.A zero-based array containing a subset of a String array based on specified filter criteria.

Исключения

Source является Nothing или не является одномерным массивом.Source is Nothing or is not a one-dimensional array.

Примеры

В этом примере демонстрируется использование функции Filter.This example demonstrates the use of the Filter function.

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)

Комментарии

Если совпадений Match не найдено в Source, функция Filter возвращает пустой массив.If no matches of Match are found within Source, the Filter function returns an empty array. Если Source имеет значение Nothing или не является одномерным массивом, возникает ошибка.An error occurs if Source is set to Nothing or is not a one-dimensional array.

Массив, возвращаемый функцией Filter, содержит достаточно элементов, чтобы вместить количество сопоставленных элементов.The array returned by the Filter function contains only enough elements to contain the number of matched items.

Аргумент Compare может иметь следующие значения.The Compare argument can have the following values.

КонстантаConstant ОписаниеDescription
КонстантаConstant ОписаниеDescription
CompareMethod.Binary Выполняет двоичное сравнениеPerforms a binary comparison
CompareMethod.Text Выполняет текстовое сравнениеPerforms a textual comparison

Дополнительно

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

Возвращает массив (с индексацией от нуля), который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

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

Параметры

Source
String[]

Обязательный.Required. Одномерный массив строк, в котором необходимо выполнить поиск.One-dimensional array of strings to be searched.

Match
String

Обязательный.Required. Строка, которую требуется найти.String to search for.

Include
Boolean

Необязательный параметр.Optional. Значение типа Boolean, указывающее, какие подстроки требуется возвращать: содержащие или не содержащие строку Match.Boolean value indicating whether to return substrings that include or exclude Match. Если параметр Include равен True, функция Filter возвращает подмножество строк массива, содержащих Match в виде подстроки.If Include is True, the Filter function returns the subset of the array that contains Match as a substring. Если параметр Include равен False, функция Filter возвращает подмножество строк массива, не содержащих Match в виде подстроки.If Include is False, the Filter function returns the subset of the array that does not contain Match as a substring.

Compare
CompareMethod

Необязательный параметр.Optional. Числовое значение, указывающее вид выполняемого сравнения строк.Numeric value indicating the kind of string comparison to use. Сведения о значениях см. в разделе "Параметры".See "Settings" for values.

Возвраты

String[]

Массив с индексацией от нуля, который содержит подмножество массива типа String, выделяемое согласно указанным условиям фильтрации.A zero-based array containing a subset of a String array based on specified filter criteria.

Исключения

Source является Nothing или не является одномерным массивом.Source is Nothing or is not a one-dimensional array.

Примеры

В этом примере демонстрируется использование функции Filter.This example demonstrates the use of the Filter function.

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)

Комментарии

Если совпадений Match не найдено в Source, функция Filter возвращает пустой массив.If no matches of Match are found within Source, the Filter function returns an empty array. Если Source имеет значение Nothing или не является одномерным массивом, возникает ошибка.An error occurs if Source is set to Nothing or is not a one-dimensional array.

Массив, возвращаемый функцией Filter, содержит достаточно элементов, чтобы вместить количество сопоставленных элементов.The array returned by the Filter function contains only enough elements to contain the number of matched items.

Аргумент Compare может иметь следующие значения.The Compare argument can have the following values.

КонстантаConstant ОписаниеDescription
CompareMethod.Binary Выполняет двоичное сравнениеPerforms a binary comparison
CompareMethod.Text Выполняет текстовое сравнениеPerforms a textual comparison

Дополнительно

Применяется к