Produce Text Representations of S-PLUS Objects

DESCRIPTION:
Creates an ASCII file representing a group of S-PLUS objects.

USAGE:
dump(list, fileout="dumpdata", full.precision = T)

REQUIRED ARGUMENTS:
list:
character vector giving the names of data objects.

OPTIONAL ARGUMENTS:
fileout:
character name of a file on which the objects will be dumped.
full.precision:
logical flag; should the dumped data be printed with enough digits to retain full binary precision when restored?

VALUE:
the character string fileout is returned.

SIDE EFFECTS:
Text representations of the objects given in list are written to file fileout.

DETAILS:
The files created by dump are ASCII text, and can be shipped to other machines that may have different binary representations of S-PLUS objects. The shipped file can then be used to restore the objects, either with source for small files, or with restore.

The mode of numeric data may be changed due to a dump/restore sequence and the restoration of large data objects that were created by dump may take inordinate amounts of memory. The functions data.dump and data.restore are recommended and have none of these drawbacks.

This function can also be used to create a backup file of important data.


WARNING:
The dump function uses sink to direct its output to fileout. This means that any sink currently in effect will be lost.

SEE ALSO:
dput , data.dump, restore, source .

EXAMPLES:
dump(ls(), "all.files")
dump(c("x", "y", "reg.xy"))