Next: asin() Up: MacAnova Help File Previous: arrays   Contents

asciisave()

Usage:
asciisave(FileName [,all:T, v335:T, v406:T, nulls:F, options:F,\
   history:T])
asciisave() repeats previous save() or asciisave() with same options



Keywords: files, general, output
asciisave(FileName) saves the MacAnova "workspace", that is, all the
current variables and option values, in a file with name given in the
quoted string or CHARACTER variable FileName.  On versions with windows
(Macintosh, Windows, Motif), FileName can be "", in which case you will
be prompted for the file name.  The file written is an ASCII coded text
file which should be readable by restore() on any computer on which
MacAnova runs.

asciisave(FileName,ascii:F) is equivalent to save(FileName), that is,
the file written will be a binary file instead of an ASCII text file.
This option can be used together with others described below.

asciisave(FileName, var1, var2, .... [,ascii:F]) saves only variables or
macros var1, var2, ... on the file.  When any of the variables saved is
specified in keyword form, the keyword is used for the name.  The items
saved can be restored without deleting everything by
restore(FileName,delete:F).

When FileName is omitted and a previous asciisave() or save() was
executed, the same file will be used as before.  Moreover, when the
previous save() specified an obsolete file format (see save() for
details), the same option will be used, unless explicitly changed.  When
there was no previous save() or asciisave(), omitting the file name is
an error.

See save() for information on keywords 'all', 'null', 'options',
'graphwind' and 'history' which control whether information on GLM
computations, option values, graph windows and previous commands
should be saved with the workspace.

asciisave() differs from save() in that asciisave() saves the
information in the form of a "text" file that can be transferred between
different types of computers.  Files created by asciisave() are often
bigger than the corresponding file created by save().  On a Macintosh,
the actual type is 'Sasc' rather than 'TEXT'.

The file produced by asciisave() consists of many short lines.  All the
characters written are printable ASCII characters (CR and space through
~), with any other characters in escaped octal format ('\t' for TAB).
The file can be printed, viewed in an editor, or sent by E-mail.  It
cannot be edited safely without specialized knowledge of the actual
format used.

See also topics restore(), 'files'


Gary Oehlert 2003-01-15