Strings.Filter Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

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

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

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

ArgumentException

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

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Resumo de manipulação da cadeia de caracteres

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

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

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

ArgumentException

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

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Resumo de manipulação da cadeia de caracteres