| load {base} | R Documentation |
Reload datasets written with the function save.
load(file, envir = parent.frame())
file |
a (readable binary) 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).
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 R[ADX]1 from R 0.99.0 to R 1.3.1.
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.
Prior to R 2.4.0 an object saved as a pairlist was
coerced to a list, silently (and undocumented).
## 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)