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

RESTORE


Syntax:     RESTORE FROM <file>/(<expC>) [ADDITIVE]

Purpose:    To retrieve memory variables from a memory (.mem) file.

Argument:   <file> is the memory (.mem) file to load from disk.

Option:     Additive: When the ADDITIVE option is specified, memory
            variables loaded from the memory file are added to the
            existing pool of memory variables.  Memory variables with
            same names are overwritten unless hidden.

            Without this clause, all existing memory variables are
            released before the memory file is loaded.

Usage:      When you RESTORE memory variables, they are initialized as
            private with the current procedure as the scope unless they
            are declared PUBLIC prior to the RESTORE and the ADDITIVE
            clause is specified.

Library:    CLIPPER.LIB


----------------------------------- Example --------------------------------

   The following 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 pseudo-array of screens.
   SAVE SCREEN TO scr_1
   SAVE ALL LIKE scr_* TO Screens

   <statements>...

   RESTORE FROM Screens ADDITIVE
   ptr = "1"
   RESTORE SCREEN FROM scr_&ptr.