4D Doc Center : LOAD SET

Home

4D v14.3

Sets

LOAD SET


LOAD SET ( {aTable ;} set ; document )

Parameter	Type	Description
aTable	Table	Table to which the set belongs, or Default table, if omitted
set	String	Name of the set to be created in memory
document	String	Document holding the set

Description

LOAD SET loads a set from document that was saved with the SAVE SET command.

The set that is stored in document must be from aTable. The set created in memory is overwritten if it already exists.

The document parameter is the name of the disk document containing the set. The document need not have the same name as the set. If you supply an empty string for document, an Open File dialog box appears so that the user can choose the set to load.

Remember that a set is a representation of a selection of records at the moment that the set is created. If the records represented by the set change, the set may no longer be accurate. Therefore, a set loaded from disk should represent a group of records that does not change frequently. A number of things can make a set invalid: modifying a record of the set, deleting a record of the set, or changing the criteria that determined a set.

Example

The following example uses LOAD SET to load a set of the Acme locations in New York:

 LOAD SET([Companies];"NY Acme";"NYAcmeSt") ` Load the set into memory

 USE SET("NY Acme") ` Change current selection to NY Acme

 CLEAR SET("NY Acme") ` Clear the set from memory

System variables and sets

If the user clicks Cancel in the Open File dialog box, or there is an error during the load operation, the OK system variable is set to 0. Otherwise, it is set to 1.