[<<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