Compartilhar via


Strings.Filter Método

Definição

Retorna uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

Sobrecargas

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

Retorna uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

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

Retorna uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

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

Origem:
Strings.vb
Origem:
Strings.vb
Origem:
Strings.vb

Retorna uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

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

Parâmetros

Source
Object[]

Obrigatórios. Matriz unidimensional de cadeias de caracteres a ser pesquisada.

Match
String

Obrigatórios. Cadeia de caracteres a ser pesquisada.

Include
Boolean

Opcional. Valor Boolean que indica se as subcadeias de caracteres que incluem ou excluem Match devem ser retornadas. Se Include for True, a função Filter retornará o subconjunto da matriz que contém Match como uma subcadeia de caracteres. Se Include for False, a função Filter retornará o subconjunto da matriz que não contém Match como uma subcadeia de caracteres.

Compare
CompareMethod

Opcional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usado. Consulte “Configurações” para obter os valores.

Retornos

String[]

Uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

Exceções

Source é Nothing ou não é uma matriz unidimensional.

Exemplos

Este exemplo demonstra o uso da Filter função .

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)

Comentários

Se nenhuma correspondência de Match for encontrada em Source, a Filter função retornará uma matriz vazia. Ocorrerá um erro se Source estiver definido Nothing como ou não for uma matriz unidimensional.

A matriz retornada pela Filter função contém apenas elementos suficientes para conter o número de itens correspondentes.

O Compare argumento pode ter os valores a seguir.

Constante Descrição
CompareMethod.Binary Executa uma comparação binária
CompareMethod.Text Executa uma comparação textual

Confira também

Aplica-se a

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

Origem:
Strings.vb
Origem:
Strings.vb
Origem:
Strings.vb

Retorna uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

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

Parâmetros

Source
String[]

Obrigatórios. Matriz unidimensional de cadeias de caracteres a ser pesquisada.

Match
String

Obrigatórios. Cadeia de caracteres a ser pesquisada.

Include
Boolean

Opcional. Valor Boolean que indica se as subcadeias de caracteres que incluem ou excluem Match devem ser retornadas. Se Include for True, a função Filter retornará o subconjunto da matriz que contém Match como uma subcadeia de caracteres. Se Include for False, a função Filter retornará o subconjunto da matriz que não contém Match como uma subcadeia de caracteres.

Compare
CompareMethod

Opcional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usado. Consulte “Configurações” para obter os valores.

Retornos

String[]

Uma matriz baseada em zero contendo um subconjunto de uma matriz String com base em critérios de filtro especificados.

Exceções

Source é Nothing ou não é uma matriz unidimensional.

Exemplos

Este exemplo demonstra o uso da Filter função .

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)

Comentários

Se nenhuma correspondência de Match for encontrada em Source, a Filter função retornará uma matriz vazia. Ocorrerá um erro se Source estiver definido Nothing como ou não for uma matriz unidimensional.

A matriz retornada pela Filter função contém apenas elementos suficientes para conter o número de itens correspondentes.

O Compare argumento pode ter os valores a seguir.

Constante Descrição
CompareMethod.Binary Executa uma comparação binária
CompareMethod.Text Executa uma comparação textual

Confira também

Aplica-se a