Write a Text Representation of an S-PLUS Object

DESCRIPTION:
Creates and uses an ASCII file representing the S-PLUS object.

USAGE:
dput(x, file)
dget(file)

REQUIRED ARGUMENTS:
x:
any S-PLUS object. Missing values (NAs) are allowed.
file:
character string giving the file name where the data structure is to be stored and later retrieved.

VALUE:
dput returns x invisibly.

dget returns the contents of file.


SIDE EFFECTS:
dput writes an version of the object onto the file. In particular, this file is suitable for moving between computers. If file is missing, the value is printed on standard output.

Any side effects in file are performed by dget.


DETAILS:
Unlike dump the result of dput does not include the object name.

The dput function is generic and has a method for objects of class "formula".


WARNING:
The exact format of the object on the file is subject to change. You should regard these files as versions of assignments.

Note also that exact equality of read-in numeric data cannot be guaranteed across machines.

For large objects, dget may use prohibitively large amounts of memory. See data.dump and data.restore.


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

EXAMPLES:
dput(abc, "oldabc") # store abc on file oldabc
def <- dget("oldabc")  # read back in