load                  package: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)

