CUT NAMED SELECTION

4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next

version 3


CUT NAMED SELECTION ({aTable; }name)

ParameterTypeDescription
aTableTableTable from which to cut selection, or
Default table, if omitted
nameStringName of the named selection to create

Description

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")

See Also

CLEAR NAMED SELECTION, COPY NAMED SELECTION, Identifiers, USE NAMED SELECTION.


4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next