\HeaderA{load}{Reload Saved Datasets}{load}
\keyword{file}{load}
\begin{Description}\relax
Reload datasets written with the function \code{save}.
\end{Description}
\begin{Usage}
\begin{verbatim}
load(file, envir = parent.frame())
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{file}] a (readable binary) connection or a character string
giving the name of the file to load.
\item[\code{envir}] the environment where the data should be loaded.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{load} can load \R{} objects saved in the current or any earlier
format.  It can read a compressed file (see \code{\LinkA{save}{save}})
directly from a file or from a suitable connection (including a call
to \code{\LinkA{url}{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
\sQuote{magic number}: magic numbers \code{1971:1977} are from \R{} <
0.99.0, and \code{R[ADX]1} from \R{} 0.99.0 to \R{} 1.3.1.
\end{Details}
\begin{Value}
A character vector of the names of objects created, invisibly.
\end{Value}
\begin{Section}{Warning}
Saved \R{} objects are binary files, even those saved with
\code{ascii = TRUE}, so ensure that they are transferred without
conversion of end of line markers.  \code{load} tries to detect this
case and give an informative error message.
\end{Section}
\begin{Note}\relax
Prior to  \R{} 2.4.0 an object saved as a \code{\LinkA{pairlist}{pairlist}} was
coerced to a \code{list}, silently (and undocumented).
\end{Note}
\begin{SeeAlso}\relax
\code{\LinkA{save}{save}}, \code{\LinkA{download.file}{download.file}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
## 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)\end{ExampleCode}
\end{Examples}

