Click above to get retro games delivered to your door ever month!

 RESTORE
 Retrieve memory variables from a memory (.mem) file
------------------------------------------------------------------------------
 Syntax

     RESTORE FROM <xcMemFile> [ADDITIVE]

 Arguments

     <xcMemFile> is the memory (.mem) file to load from disk.  If an
     extension is not specified, the extension (.mem) is assumed.  The
     filename may be specified as a literal string or as a character
     expression enclosed in parentheses.

     ADDITIVE causes memory variables loaded from the memory file to be
     added to the existing pool of memory variables.

 Description

     RESTORE is a memory variable command that recreates public and private
     variables previously SAVEd to a memory (.mem) file and initializes them
     with their former values.  The scope of the variable is not SAVEd with
     the variable but is instead established when the variable is RESTOREd.
     Arrays and local variables cannot be SAVEd or RESTOREd.

     When memory variables are RESTOREd, they are recreated as private
     variables with the scope of the current procedure or user-defined
     function unless they exist as public variables and you specify the
     ADDITIVE clause .  If ADDITIVE is specified, public and private
     variables with the same names are overwritten unless hidden with
     PRIVATE.  If ADDITIVE is not specified, all public and private variables
     are released before the memory file is loaded.

     Local and static variables are unaffected by RESTORE.  If a local or
     static variable has been declared in the current procedure or
     user-defined function, and a variable with the same name is RESTOREd,
     only the local or static variable is visible unless references to the
     RESTOREd variable are prefaced with the MEMVAR alias.

 Examples

     .  This example demonstrates a typical application of SAVE and
        RESTORE.  Here memory variables containing screens are SAVEd TO and
        RESTOREd FROM memory files:

        // Create and use a pseudoarray of screens
        SAVE SCREEN TO cScreen1
        SAVE ALL LIKE cScreen* TO Screens
        //
        <statements>...
        //
        RESTORE FROM Screens ADDITIVE
        nNumber = "1"
        RESTORE SCREEN FROM ("cScreen" + nNumber)

 Files:  Library is CLIPPER.LIB.