SET FILTER
 Oculta los registros que no cumplen una condición
------------------------------------------------------------------------------
 Sintaxis

     SET FILTER TO [<lCondición>]

 Argumentos

     TO <lCondición> es una expresión lógica que define un conjunto
     específico de registros del área de trabajo actual accesibles para su
     proceso.

     SET FILTER TO sin argumentos desactiva la condición de filtro.

 Descripción

     Cuando se establece una condición de filtro, el área de trabajo actual
     actúa como si sólo contuviera los registros que cumplen la condición
     especificada. Una condición de filtro es una de las propiedades de un
     área de trabajo. Una vez establecido un filtro, la condición puede
     devolverse como una cadena de caracteres utilizando la función
     DBFILTER().

     La mayoría de los mandatos y funciones que desplazan el puntero del
     registro respetan el filtro actual, con la excepción de aquellos
     mandatos que acceden a registros por su número. Esto incluye mandatos
     GOTO especificados con la cláusula RECORD y relaciones enlazadas con un
     área de trabajo sin índice activo mediante una expresión numérica.

     Una vez establecido un filtro, no se activa hasta que el puntero del
     registro se desplaza de su posición actual. Puede utilizar GO TOP para
     activarlo.

     Al igual que con SET DELETED, un filtro no tiene efecto en INDEX y
     REINDEX.

     Nota: Aunque SET FILTER hace que el área de trabajo actual
     aparezca como si contuviera un subconjunto de registros, de hecho
     procesa secuencialmente todos los registros del área. Debido a esto, el
     tiempo necesario para procesar un área de trabajo con filtro será el
     mismo que el empleado para procesarla sin él.

 Ejemplos

      Este ejemplo establece un filtro para los registros del
        fichero Empleado.dbf en los que la edad es superior a 50:

        USE Empleado INDEX Nombre NEW
        SET FILTER TO Edad > 50
        LIST Apellido, Nombre, Edad, Telefono
        SET FILTER TO

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: DBFILTER() DBSETFILTER() SET DELETED