load                  package:base                  R Documentation

_R_e_l_o_a_d _S_a_v_e_d _D_a_t_a_s_e_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Reload datasets written with the function 'save'.

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

    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.

_D_e_t_a_i_l_s:

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

_V_a_l_u_e:

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

_W_a_r_n_i_n_g:

     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.

_N_o_t_e:

     Prior to  R 2.4.0 an object saved as a 'pairlist' was coerced to a
     'list', silently (and undocumented).

_S_e_e _A_l_s_o:

     'save', 'download.file'.

_E_x_a_m_p_l_e_s:

     ## 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/kprats.rda")
     ## print the value to see what objects were created.
     print(load(con))
     close(con)
     ## End(Not run)

