load {base} | R Documentation |
Reload datasets written with the function save
.
load(file, envir = parent.frame())
file |
a (readable binary-mode) connection or a character string giving the name of the file to load. |
envir |
the environment where the data should be loaded. |
load
can load R objects saved in the current or any earlier
format. It can read a compressed file (see save
)
directly from a file or from a suitable connection (including a call
to url
).
A not-open connection will be opened in mode "rb"
and closed
after use. Any connection other than a gzfile
connection will be wrapped in gzcon
to allow compressed
saves to be handled: note that this leaves the connection in an
altered state (in particular, binary-only).
Only R objects saved in the current format (used since R 1.4.0) can be read from a connection. If no input is available on a connection a warning will be given, but any input not in the current format will result in a error.
Loading from an earlier version will give a warning about the
‘magic number’: magic numbers 1971:1977
are from R <
0.99.0, and RD[ABX]1
from R 0.99.0 to R 1.3.1. These are all
obsolete, and you are strongly recommended to re-save such files in a
current format.
A character vector of the names of objects created, invisibly.
Saved R objects are binary files, even those saved with
ascii = TRUE
, so ensure that they are transferred without
conversion of end of line markers. load
tries to detect this
case and give an informative error message.
For other interfaces to the underlying serialization format, see
unserialize
and .readRDS
.
## save all data xx <- pi # to ensure there is some data save(list = ls(all=TRUE), file= "all.RData") rm(xx) ## restore the saved values to the current environment local({ load("all.RData") ls() }) ## restore the saved values to the user's workspace load("all.RData", .GlobalEnv) unlink("all.RData") ## Not run: con <- url("http://some.where.net/R/data/example.rda") ## print the value to see what objects were created. print(load(con)) close(con) # url() always opens the connection ## End(Not run)