RESTORE FROM Command

Example   See Also

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

Syntax

RESTORE FROM FileName | MEMO MemoFieldName
  [ADDITIVE]

Arguments

FileName

Specifies the variable file from which the variables and arrays are restored. Variable files are assigned a .mem extension.

MEMO MemoFieldName

Specifies the memo field from which variables and arrays are restored.

ADDITIVE

Prevents any variables or arrays currently in memory from being erased. If the number of variables or arrays being added with ADDITIVE plus the number of existing variables exceeds the variable limit, Microsoft Visual FoxPro brings as many variables and arrays as possible into memory from the variable file or memo field.

If you restore a variable or array that has the same name as an existing variable or array, the value in the existing variable or array is overwritten with the value of the restored variable or array.

Remarks

When RESTORE FROM is issued in a program, all PUBLIC and PRIVATE variables and arrays are restored as PRIVATE; all LOCAL variables and arrays are restored as LOCAL. If RESTORE is issued in the Command window, PUBLIC and PRIVATE variables and arrays are restored as PUBLIC; LOCAL variables and arrays are restored as LOCAL.

RESTORE FROM clears any variables or arrays currently in memory unless you include the ADDITIVE keyword. RESTORE FROM does not affect system variables.

Note that object type variables cannot be restored from a variable file or memo field.