load
Reload Saved Datasets

Description

Reloads objects (saved with the save function) from a dataset file or connection.

Usage

load(file, envir = parent.frame(), verbose = FALSE)

Arguments

file a character string specifying the dataset's filename or connection object.
envir an environment where the loaded objects are assigned.
verbose a logical value. This argument is currently ignored.

Details

This function supports the RData and (Spotfire Enterprise Runtime for R-specific) SData formats.
Only use load for input you know you can trust. load deserializes the input and, if the input has been manipulated, the deserialization can lead to execution of malicious code.
The engine can load most files saved from R, with a few exceptions. If the file contains complicated model objects such as a glm model, the load might fail or the model might be corrupt. (Such models contain references to implementation-specific functions that are different between Spotfire Enterprise Runtime for R and R. Some non-trivial environments might also cause problems.)
If the file was not created with the save function, or if the file contains unsupported features, an error is displayed.
Value
returns a character vector with the names of the loaded objects.
Side Effects
The loaded objects are assigned to the envir environment.
See Also
save, data
Examples
# Example to load from a file.
rm(list = ls())  
x <- runif(10)
y <- rnorm(10)
z <- lm(y~x)
a <- matrix(1:12, nrow = 3)
save(list = ls(), file = "test.data", compress = "bzip2")
rm(list = ls())  
load("test.data")
ls()
rm(list = ls())  

my_env <- new.env() load("test.data", my_env) # load to another environment ls(envir = my_env) unlink("test.data")

# Example to load from a connection rm(list = ls()) x <- runif(10) y <- rnorm(10) z <- lm(y~x) a <- matrix(1:12, nrow = 3) save(list = ls(), file = "test.data") rm(list = ls()) con <- file("test.data", "rb") load(con) ls() close(con) unlink("test.data")

Package base version 6.1.5-18
Package Index