# R: Reload Saved Datasets

load {base} | R Documentation

## Reload Saved Datasets

### Description

Reload datasets written with the function `save`.

### Usage

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

### Arguments

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

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

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.

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

[Package base version 2.6.0 Index]