load {base}R Documentation

Reload Saved Datasets

Description

Reload datasets written with the function save.

Usage

load(file, envir = parent.frame())
loadURL(url, envir = parent.frame(), quiet = TRUE, ...)

Arguments

file a connection or a character string giving the name of the file to load.
envir the environment where the data should be loaded.
url a character string naming a URL.
quiet, ... additional arguments to download.file.

Details

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).

loadURL is a convenience wrapper which downloads a file, loads it and deletes the downloaded copy.

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.

Value

A character vector of the names of objects created, invisibly.

Warning

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.

See Also

save, download.file.

Examples

## save all data
save(list = ls(all=TRUE), file= "all.Rdata")

## restore the saved values to the current environment
load("all.Rdata")

## restore the saved values to the user's workspace
load("all.Rdata", .GlobalEnv)

## Not run: 
## print the value to see what objects were created.
print(loadURL("http://some.where.net/R/data/kprats.rda"))
# or, avoiding making a local copy,
print(load(url("http://some.where.net/R/data/kprats.rda")))
## End(Not run)

[Package base version 2.0.0 Index]