This function takes a vector of names of R objects and produces
text representations of the objects on a file or connection.
dump file can usually be
sourced into another
dump(list, file = "dumpdata.R", append = FALSE, control = "all", envir = parent.frame(), evaluate = TRUE)
character vector. The names of one or more R objects to be dumped.
either a character string naming a file or a
"" indicates output to the console.
file is a character string,
output will be appended to
file; otherwise, it will overwrite
the contents of
character vector indicating deparsing options.
.deparseOpts for their description.
the environment to search for objects.
logical. Should promises be evaluated?
An invisible character vector containing the names of the objects which were dumped.
If some of the objects named do not exist (in scope), they are
omitted, with a warning. If
file is a file and no objects
exist then no file is created.
sourceing may not produce an identical copy of
dumped objects. A warning is issued if it is likely that
problems will arise, for example when dumping exotic or complex
objects (see the Note).
dump will also warn if fewer characters were written to a file
than expected, which may indicate a full or corrupt file system.
dump file can be
sourced into another R (or
perhaps S) session, but the function
save is designed to
be used for transporting R data, and will work with R objects that
dump does not handle. For maximal reproducibility use
control = c("all", "hexNumeric").
To produce a more readable representation of an object, use
control = NULL. This will skip attributes, and will make other
simplifications that make
source less likely to produce an
identical copy. See
deparse for details.
To deparse the internal representation of a function rather than
displaying the saved source, use
control = c("keepInteger",
"warnIncomplete", "keepNA"). This will lose all formatting and
comments, but may be useful in those cases where the saved source is
no longer correct.
Promises will normally only be encountered by users as a result of
lazy-loading (when the default
evaluate = TRUE is essential)
and after the use of
evaluate = FALSE might be intended.
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.