CUT NAMED SELECTION

CUT NAMED SELECTION ( {tabela ;} nome )

Parâmetro	Tipo		Descrição
tabela	Tabela	🡒	Tabela da qual cortar seleção, ou Tabela por padrão, se omitida
nome	String	🡒	Nome da seleção temporal a criar

Descrição

CUT NAMED SELECTION cria uma seleção temporal nome e coloca ali a seleção atual de tabela. Diferente de COPY NAMED SELECTION, este comando não copia a seleção atual de tabela, mas a move a própria tabela selecionada.

Depois de executar o comando, a seleção atual de tabela no processo atual fica vazia. Portanto, CUT NAMED SELECTION não deve ser utilizado quando um registro está sendo modificado.

CUT NAMED SELECTION é mais eficiente em termos de utilização de memória, que COPY NAMED SELECTION. COPY NAMED SELECTION, utiliza 4 bytes de memória por cada registro da seleção. CUT NAMED SELECTION, só a referência à lista é movida.

Exemplo

O método seguinte vazia a seleção atual de uma tabela [Clientes]:

 CUT NAMED SELECTION([Clientes];"AEliminar")
 CLEAR NAMED SELECTION("AEliminar")

Ver também

CLEAR NAMED SELECTION
COPY NAMED SELECTION
USE NAMED SELECTION