RESTORE

Class

Memory Variables

Purpose

Restore memory variables and arrays previously saved with the SAVE command

Syntax

RESTORE FROM <.mem filename> | (<expC>)

[ADDITIVE]

[FOXPRO]

See Also

DB_FOXMEM, DISPLAY STATUS, MODIFY COMMAND, PRIVATE, PUBLIC, RELEASE, SAVE, STORE

Description

The RESTORE command restores memory variables and arrays previously saved with the SAVE TO <.mem filename> command. The file name can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename. All variables that exist prior to the RESTORE command being issued are released unless the ADDITIVE option is specified. The memory variables that are restored are all declared as PRIVATE at the current level, regardless of whether they were PRIVATE or PUBLIC when they were saved. If no file extension is specified on the FROM file, then '.mem' is used.

The Recital/4GL memory files are normal ASCII text files which can be modified with MODIFY COMMAND. They contain a series of STORE...TO commands, produced by the SAVE command.

If the FOXPRO keyword is specified, the memory files are treated as FoxPro style binary files. The FOXPRO keyword is not required: the RESTORE command will recognize the file format automatically.

Example

restore from monday additive

Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer