4D v14.3

LOAD SET

Home

 
4D v14.3
LOAD SET

LOAD SET 


 

LOAD SET ( {aTable ;} set ; document ) 
Parameter Type   Description
aTable  Table in Table to which the set belongs, or Default table, if omitted
set  String in Name of the set to be created in memory
document  String in Document holding the set

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

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.

 
PROPERTIES 

Product: 4D
Theme: Sets
Number: 185

The OK variable is changed by the command

 
HISTORY 

Created: < 4D v6

 
SEE ALSO 

SAVE SET

 
ARTICLE USAGE

4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v11 SQL Release 6)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)