|
|
|
|
- filtros
- Navegación filtrada
- Habilitar/Deshabilitar un filtro
HFilterContiene (Función)
Disponible solo con este tipo de conexión
Define y activa un filtro de tipo "Contiene" en un archivo de datos, vista o consulta. El filtro de tipo "Contiene" permite seleccionar todos los registros que contienen un conjunto específico de caracteres. Este filtro no distingue entre mayúsculas y minúsculas. Este filtro no utiliza ningún índice, navega por todo el archivo de datos. SearchKey is string = HFilterContains(Customer, Comment, "VIP") HReadFirst(Customer, SearchKey) WHILE NOT HOut() Trace(Customer.CustomerName, Customer.City) HReadNext(Customer, SearchKey) END // Disables the filter HDeactivateFilter(Customer)
Sintaxis
<Result> = HFilterContains(<Data file> , <Item> , <Value>)
<Result>: Cadena de caracteres Campo de navegación. Corresponde a: - el nombre del elemento utilizado para el bucle de el archivo de datos si el filtro está activado,
- una cadena vacía ("") si no se puede establecer el filtro.
<Data file>: Cadena de caracteres Nombre del archivo de datos HFSQL, vista o consulta utilizada. <Item>: Cadena de caracteres Nombre del elemento sobre el que se implementará el filtro. Esta posición puede ser una posición clave o no clave. <Value>: Cadena de caracteres El valor que se debe encontrar en el artículo de Record. Observaciones filtros - El filtro se activa desde el momento en el que se llama a la función HFilterContiene.
- Equivalente de sintaxis:
HFilterContains(FileName, ItemName, "Value")
equivale a:
HFilter(FileName, "ItemName ~]'Value'")
Navegación filtrada Cuando se define y se activa un filtro en un archivo de datos, cualquier lectura de Record corresponde al filtro. Si no hay ninguna otra Record que corresponda al filtro durante la iteración: - La función HOut devuelve True.
- la actual Record corresponde a la última Record leída con el filtro.
Por ejemplo: | | En un archivo de datos filtrado, después de la función: | el actual Record es: |
---|
HReadFirst | el primer archivo Record correspondiente al filtro. | HReadLast | el último archivo Record correspondiente al filtro. | HReadNext (o HForward) | el siguiente Record (o el siguiente n-ésimo Record) correspondiente al filtro. | HReadPrevious (o HBackward) | el anterior Record (o el anterior n-ésimo Record) correspondiente al filtro. |
Habilitar/Deshabilitar un filtro - HDeactivateFilter se utiliza para desactivar un filtro.
- HActivateFilter se utiliza para volver a habilitar un filtro.
- El filtro se elimina cuando se cierra el archivo de datos (consulta o vista) (HClose o HOpenAnalysis, por ejemplo).
- Un único filtro puede existir en un momento dado en un archivo de datos (consulta o vista). Si la función HFilterContiene se utiliza varias veces, solo se tendrá en cuenta el último filtro: se borrarán los filtros anteriores. Del mismo modo, si se utilizan varios filtros (funciones HFilter*), sólo se tendrá en cuenta el último filtro.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|