Strings.Filter Método
Definición
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.Returns a zero-based array containing a subset of a String array based on specified filter criteria.
Sobrecargas
| Filter(Object[], String, Boolean, CompareMethod) |
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz |
| Filter(String[], String, Boolean, CompareMethod) |
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz |
Filter(Object[], String, Boolean, CompareMethod)
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.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);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[]
Obligatorio.Required. Matriz unidimensional de cadenas en la que se va a buscar.One-dimensional array of strings to be searched.
- Match
- String
Obligatorio.Required. Cadena que se va a buscar.String to search for.
- Include
- Boolean
Opcional.Optional. Valor de tipo Boolean que indica si se van a devolver subcadenas que incluyen o excluyen Match.Boolean value indicating whether to return substrings that include or exclude Match. Si el valor de Include es True, la función Filter devuelve el subconjunto de la matriz que contiene Match como subcadena.If Include is True, the Filter function returns the subset of the array that contains Match as a substring. Si el valor de Include es False, la función Filter devuelve el subconjunto de la matriz que no contiene Match como subcadena.If Include is False, the Filter function returns the subset of the array that does not contain Match as a substring.
- Compare
- CompareMethod
Opcional.Optional. Valor numérico que indica el tipo de comparación de cadenas que se va a utilizar.Numeric value indicating the kind of string comparison to use. Consulte los valores en "Configuración".See "Settings" for values.
Devoluciones
- String[]
Matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.A zero-based array containing a subset of a String array based on specified filter criteria.
Excepciones
Source es Nothing o no es una matriz unidimensional.Source is Nothing or is not a one-dimensional array.
Ejemplos
En este ejemplo se muestra el uso de la Filter función.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)
Comentarios
Si no se encuentran coincidencias de Match en Source , la Filter función devuelve una matriz vacía.If no matches of Match are found within Source, the Filter function returns an empty array. Se produce un error si Source se establece en Nothing o no es una matriz unidimensional.An error occurs if Source is set to Nothing or is not a one-dimensional array.
La matriz devuelta por la Filter función contiene solo los elementos suficientes para contener el número de elementos coincidentes.The array returned by the Filter function contains only enough elements to contain the number of matched items.
El Compare argumento puede tener los valores siguientes.The Compare argument can have the following values.
| ConstanteConstant | DescripciónDescription |
|---|---|
CompareMethod.Binary |
Realiza una comparación binariaPerforms a binary comparison |
CompareMethod.Text |
Realiza una comparación textualPerforms a textual comparison |
Consulte también
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumen de la manipulación de cadenasString Manipulation Summary
Se aplica a
Filter(String[], String, Boolean, CompareMethod)
Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.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);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[]
Obligatorio.Required. Matriz unidimensional de cadenas en la que se va a buscar.One-dimensional array of strings to be searched.
- Match
- String
Obligatorio.Required. Cadena que se va a buscar.String to search for.
- Include
- Boolean
Opcional.Optional. Valor de tipo Boolean que indica si se van a devolver subcadenas que incluyen o excluyen Match.Boolean value indicating whether to return substrings that include or exclude Match. Si el valor de Include es True, la función Filter devuelve el subconjunto de la matriz que contiene Match como subcadena.If Include is True, the Filter function returns the subset of the array that contains Match as a substring. Si el valor de Include es False, la función Filter devuelve el subconjunto de la matriz que no contiene Match como subcadena.If Include is False, the Filter function returns the subset of the array that does not contain Match as a substring.
- Compare
- CompareMethod
Opcional.Optional. Valor numérico que indica el tipo de comparación de cadenas que se va a utilizar.Numeric value indicating the kind of string comparison to use. Consulte los valores en "Configuración".See "Settings" for values.
Devoluciones
- String[]
Matriz basada en cero que contiene un subconjunto de una matriz String basada en criterios de filtro especificados.A zero-based array containing a subset of a String array based on specified filter criteria.
Excepciones
Source es Nothing o no es una matriz unidimensional.Source is Nothing or is not a one-dimensional array.
Ejemplos
En este ejemplo se muestra el uso de la Filter función.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)
Comentarios
Si no se encuentran coincidencias de Match en Source , la Filter función devuelve una matriz vacía.If no matches of Match are found within Source, the Filter function returns an empty array. Se produce un error si Source se establece en Nothing o no es una matriz unidimensional.An error occurs if Source is set to Nothing or is not a one-dimensional array.
La matriz devuelta por la Filter función contiene solo los elementos suficientes para contener el número de elementos coincidentes.The array returned by the Filter function contains only enough elements to contain the number of matched items.
El Compare argumento puede tener los valores siguientes.The Compare argument can have the following values.
| ConstanteConstant | DescripciónDescription |
|---|---|
CompareMethod.Binary |
Realiza una comparación binariaPerforms a binary comparison |
CompareMethod.Text |
Realiza una comparación textualPerforms a textual comparison |
Consulte también
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumen de la manipulación de cadenasString Manipulation Summary