Strings.Filter Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 |
| Filter(String[], String, Boolean, CompareMethod) |
Retorna uma matriz baseada em zero contendo um subconjunto de uma matriz |
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
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
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumo de manipulação da cadeia de caracteres
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
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
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumo de manipulação da cadeia de caracteres
