[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
SAVE
Save variables to a memory (.mem) file
------------------------------------------------------------------------------
Syntax
SAVE TO <xcMemFile> [ALL [LIKE | EXCEPT <skeleton>]]
Arguments
<xcMemFile> is the memory (.mem) file to SAVE to disk. You may
specify the file name as a literal string or as a character expression
enclosed in parentheses. If you specify no extension, the file is
created with a .mem extension.
ALL [LIKE|EXCEPT <skeleton>] defines the set of visible private and
public memory variables to save to <xcMemFile>. <skeleton> is the
wildcard mask that characterizes a group of memory variables to SAVE.
The wildcard characters supported are * and ?.
Description
SAVE copies public and private memory variables visible within the
current procedure or user-defined function to a memory (.mem) file.
Arrays and local and static variables, however, cannot be SAVEd. When
variables are SAVEd, they are copied without any reference to scope.
Variables hidden by PRIVATE or LOCAL declarations are not SAVEd.
If you specify the ALL LIKE clause, variable names matching the
<skeleton> mask are saved. By contrast, if you specify ALL EXCEPT,
variable names not matching the <skeleton> are saved.
You can specify a <skeleton> that includes wildcard characters. The
* wildcard character matches any group of adjacent characters ending a
variable name and can be specified only at the end of the <skeleton>.
The ? wildcard character matches any single character and can be
specified anywhere within the <skeleton>.
Examples
. This example saves all visible private and public variables to
Temp.mem:
PRIVATE cOne := "1"
SAVE ALL TO Temp
. This example saves all visible private and public variables
with names beginning with "c" to Myvars.mem:
SAVE ALL LIKE c* TO MyVars
. This example saves all visible private and public variables
with names that do not begin with "c" to Myvars2.mem:
SAVE ALL EXCEPT c* TO MyVars2
Files Library is CLIPPER.LIB.
See Also:
LOCAL
PRIVATE
PUBLIC
RESTORE
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson