\Header{save}{Save \R Objects}
\alias{save.image}{save}
\keyword{file}{save}
\begin{Usage}
\begin{verbatim}
save(..., list = character(0), file = "", ascii = FALSE)
save.image()
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{...}] the names of the objects to be saved.
\item[\texttt{list}] A character vector containing the names of objects to be
saved.
\item[\texttt{file}] the name of the file where the data will be saved.
\item[\texttt{ascii}] if \texttt{TRUE}, an ASCII representation of the data is
written.  This is useful for transporting data between machines of
different types.  The default value of \texttt{ascii} is \texttt{FALSE}
which leads to a more compact binary file being written.
\end{ldescription}
\end{Arguments}
\begin{Description}
\texttt{save} writes a external representation of \R\ objects to the
specified file.  The objects can be read back from the file at a later
date by using the function \texttt{load}.

\texttt{save.image()} is just a short-cut for ``save my current
environment'',
i.e., \texttt{save(list = ls(), file = ".RData")}. It is what also
happens with \texttt{\Link{q}("yes")}.\end{Description}
\begin{SeeAlso}
\texttt{\Link{dput}}, \texttt{\Link{dump}}, \texttt{\Link{load}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
x <- runif(20)
y <- list(a = 1, b = TRUE, c = "oops")
save(x, y, file = "xy.Rdata")
save.image()
\end{ExampleCode}
\end{Examples}

