4D v13.4

CUT NAMED SELECTION

Home

 
4D v13.4
CUT NAMED SELECTION

CUT NAMED SELECTION 


 

CUT NAMED SELECTION ( {aTable ;} name ) 
Parameter Type   Description
aTable  Table in Table from which to cut selection, or Default table, if omitted
name  String in Name of the named selection to create

CUT NAMED SELECTION creates a named selection name and moves the current selection of aTable to it. This command differs from COPY NAMED SELECTION in that it does not copy the current selection, but moves the current selection of table itself.

After the command has been executed, the current selection of aTable in the current process becomes empty. Therefore, CUT NAMED SELECTION should not be used while a record is being modified.

CUT NAMED SELECTION is more memory efficient than COPY NAMED SELECTION. With COPY NAMED SELECTION, 4 bytes times the number of selected records is duplicated in memory. With CUT NAMED SELECTION, only the reference to the list is moved.

Example  

The following method empties the current selection of a table [Customers]:

 CUT NAMED SELECTION([Customers];"ToBeCleared")
 CLEAR NAMED SELECTION("ToBeCleared")

 
PROPERTIES 

Product: 4D
Theme: Named Selections
Number: 334

The command changes the current selection

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: < 4D v6

 
SEE ALSO 

CLEAR NAMED SELECTION
COPY NAMED SELECTION
Identifiers
USE NAMED SELECTION