+---------------------------------+
|          RESTORE FROM           |
+---------------------------------+
RESTORE FROM <file>
        | FROM MEMO <memo field>
        [ADDITIVE]

-----------------------------------
Restores memory variables and arrays from memory variable file or memo
field.
-----------------------------------

RESTORE retrieves memory variables and memory variable arrays previously
saved in a memory variable file or a memo field and places them into
memory.

When RESTORE is issued from within a program, all the memory variables
and arrays are restored as PRIVATE.  If RESTORE is issued from the
Command window, then memory variables and arrays are restored as PUBLIC.

When RESTORE FROM is issued, any memory variables or arrays currently in
memory are erased unless ADDITIVE is included.

System memory variables are not affected by RESTORE FROM or SAVE TO.

RESTORE FROM <file>
        Restores memory variables and memory variable arrays from the specified
memory variable file.

RESTORE FROM <memo field>
        Restores memory variables and memory variable arrays from the specified
memo field.

ADDITIVE
        When RESTORE FROM is issued, any memory variables or arrays currently
in memory are erased unless ADDITIVE is included.  If the number of
memory variables or arrays being added with the ADDITIVE option exceeds
the memory variable limit, then as many memory variables and arrays as
possible will be brought into memory from the memory variable file or
memo field.  Memory variable files are assigned a .MEM extension.

        If you restore a variable that has the same name as an existing
variable, the value in the existing variable is changed to the value
from the memory variable file or memo field value.

+---------------------------------+
|         Program Example         |
+---------------------------------+
In this example two memory variables are created, saved to a memory
variable save file and restored without replacing a third memory
variable.

val1 = 50
val2 = 'Hello'
SAVE TO temp
CLEAR MEMORY
val3 = DATE()
RESTORE FROM temp ADDITIVE
DISPLAY MEMORY LIKE val?

-----------------------------------

See Also:  DECLARE, DIMENSION, PRIVATE, PUBLIC, SAVE TO, RELEASE

-----------------------------------