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