SET FILTER
 Esconde registros que nao atendam uma condiçao
------------------------------------------------------------------------------

 Sintaxe

     SET FILTER TO [<lCondiçao>]

 Argumentos

     <lCondiçao> é uma expressao lógica que define um conjunto
     específico de registros das área de trabalho corrente que sejam
     acessíveis para processamento.

     SET FILTER TO sem um argumento desativa a condiçao filtro.

 Descriçao

     Quando uma condiçao FILTER está ativa, a área de trabalho corrente age
     como se contivesse somente os registros que atendem a condiçao
     especificada.  Uma condiçao FILTER é uma das propriedades de uma área
     de trabalho.  Uma vez ativada, a condiçao pode ser retornada na forma
     de uma cadeia de caracteres usando-se a funçao DBFILTER().

     A maioria dos comandos e funçoes que movem o ponteiro de registros
     obedece ao filtro corrente, com exceçao daqueles comandos que acessam
     registros através do número dos mesmos.  Isto inclui GOTO, comandos
     especificados com a cláusula RECORD, e relaçoes conectadas por
     expressao numérica a uma área de trabalho que nao possua nenhum índice
     ativo.

     Uma vez estabelecido, um FILTER nao é ativado até que o ponteiro de
     registro seja movido de sua posiçao corrente.  Você pode utilizar GO
     TOP para ativá-lo.

     Tal como SET DELETED, um filtro nao tem efeito algum sobre os comandos
     INDEX e REINDEX.

     -----------------------------------------------------------------------
     . Nota

     Embora o comando SET FILTER atue na área de trabalho corrente de forma
     que ela pareça conter um subconjunto de registros, este comando na
     realidade processa sequencialmente todos os registros na área de
     trabalho.  Por esta razao, o tempo necessário para o processamento de
     uma área de trabalho filtrada será o mesmo que numa área de trabalho
     nao filtrada.
     -----------------------------------------------------------------------

 Exemplos

     Este exemplo filtra somente aqueles registros onde a idade seja maior
     do que 50 no arquivo Employee.dbf:

     USE Employee INDEX Name NEW
     SET FILTER TO Age > 50
     LIST Lastname, Firstname, Age, Phone
     SET FILTER TO

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: SET DELETED DBFILTER()