\HeaderA{remove}{Remove Objects from a Specified Environment}{remove}
\aliasA{rm}{remove}{rm}
\keyword{environment}{remove}
\begin{Description}\relax
\code{remove} and \code{rm} can be used to remove objects.  These can
be specified successively as character strings, or in the character
vector \code{list}, or through a combination of both.  All objects
thus specified will be removed.

If \code{envir} is NULL then the currently active environment is
searched first.

If \code{inherits} is \code{TRUE} then parents of the supplied
directory are searched until a variable with the given name is
encountered.  A warning is printed for each variable that is not
found.
\end{Description}
\begin{Usage}
\begin{verbatim}
remove(..., list = character(0), pos = -1,
       envir = as.environment(pos), inherits = FALSE)

rm    (..., list = character(0), pos = -1,
       envir = as.environment(pos), inherits = FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{...}] the objects to be removed, supplied individually and/or as a
character vector
\item[\code{list}] a character vector naming objects to be removed.
\item[\code{pos}] where to do the removal.  By default, uses the
current environment.  See the details for other possibilities.
\item[\code{envir}] the \code{\LinkA{environment}{environment}} to use. See the details section.
\item[\code{inherits}] should the enclosing frames of the environment be
inspected?
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The \code{pos} argument can specify the  environment from which to remove
the objects in any of several ways:
as an integer (the position in the \code{\LinkA{search}{search}} list); as
the character string name of an element in the search list; or as an
\code{\LinkA{environment}{environment}} (including using \code{\LinkA{sys.frame}{sys.frame}} to
access the currently active function calls).
The \code{envir} argument is an alternative way to specify an
environment, but is primarily there for back compatibility.
\end{Details}
\begin{References}\relax
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
\emph{The New S Language}.
Wadsworth \& Brooks/Cole.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{ls}{ls}}, \code{\LinkA{objects}{objects}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
tmp <- 1:4
## work with tmp  and cleanup
rm(tmp)

## Not run: 
## remove (almost) everything in the working environment.
## You will get no warning, so don't do this unless you are really sure.
rm(list = ls())
## End(Not run)\end{ExampleCode}
\end{Examples}

