DELETE
 Marca registros para eliminaçao
------------------------------------------------------------------------------

 Sintaxe

     DELETE [<abrangência> [WHILE <lCondiçao>] [FOR <lCondiçao>]

 Argumentos 

     <abrangência> é a porçao do arquivo de dados corrente a ser
     eliminada.  Se abrangência nao for especificada, o comando DELETE agirá
     somente no registro corrente. Se uma <abrangência> ou cláusula
     condicional for especificada, o padrao torna-se todos (ALL) os
     registros.

     WHILE <lCondiçao> especifica o conjunto dos registros que atendem a
     condiçao do registro corrente até que a condiçao seja falsa.

     FOR <lCondiçao> especifica o conjunto de registros condicional a
     ser eliminado dentro da abrangência.

 Descriçao

     O comando DELETE marca os registros para que eles possam ser filtrados
     com o comando SET DELETED ON, identificados com a funçao DELETED(), ou
     fisicamente removidos do arquivo de dados com o comando PACK.  Além
     disso, comandos de visualizaçao de registros como, por exemplo, LIST e
     DISPLAY identificam os registros marcados para eliminaçao com um
     asterisco (*).  Uma vez marcados os registros, você pode recuperá-los
     usando o comando RECALL.  Se você desejar remover todos os registros de
     um arquivo de dados, use o comando ZAP ao invés dos comandos DELETE ALL
     e PACK.

     Num ambiente de rede, o comando DELETE pede que o registro corrente
     seja travado através da funçao RLOCK(), caso você esteja marcando um
     único registro.  Se você estiver marcando vários registros, o arquivo
     de dados corrente deve ser travado com a funçao FLOCK() ou aberto
     EXCLUSIVE.  Consulte o capítulo Programando em Rede no livro
     Programando e Utilitários para mais informaçoes.

 Notas

       Marcaçao com o comando SET DELETED ON: Se o registro
        corrente for eliminado com o comando SET DELETED ON, ele permanecerá
        visível até que o ponteiro de registro seja movido.

 Exemplos

     Este exemplo demonstra como deve ser especificada a cláusula FOR para
     marcar um conjunto de registros a ser eliminado:

     USE Sales INDEX Salesman NEW
     DELETE ALL FOR Inactive

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

See Also: PACK RECALL SET DELETED ZAP DBEVAL() DELETED()