Skip to main content
Version: Next

USE NAMED SELECTION

USE NAMED SELECTION ( name )

ParameterTypeDescription
nameText→Name of named selection to be used

Description​

USE NAMED SELECTION uses the named selection name as the current selection for the table to which it belongs.

When you create a named selection, the current record is “remembered” by the named selection. USE NAMED SELECTION retrieves the position of this record and makes the record the new current record; this command loads the current record. If the current record was modified after name was created, the record should be saved before USE NAMED SELECTION is executed, in order to avoid losing the modified information.

  • If COPY NAMED SELECTION was used to create name, the named selection name is copied to the current selection of the table to which name belongs. The named selection name exists in memory until it is cleared. Use the CLEAR NAMED SELECTION command to clear the named selection and free the memory used by name.
  • If CUT NAMED SELECTION was used to create name, the current selection is set to name and name no longer exists in memory.

Remember that a named selection is a representation of a selection of records at the moment that the named selection is created. If the records represented by the named selection change, the named selection may no longer be accurate. Therefore, a named selection represents a group of records that does not change frequently. A number of things can invalidate a named selection: modifying a record of the named selection, deleting a record of the named selection, or changing the criterion that determined the named selection.

See also​

CLEAR NAMED SELECTION
COPY NAMED SELECTION
CUT NAMED SELECTION

Properties​

Command number332
Thread safe✓
Changes current record
Changes current selection