\Header{exists}{Is an Object Defined?}
\keyword{data}{exists}
\begin{Description}\relax
Search for an \R{} object of the given name on the search path.\end{Description}
\begin{Usage}
\begin{verbatim}
exists(x, where = -1, envir = , frame, mode = "any", inherits = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] a variable name (given as a character string).
\item[\code{where}] where to look for the object (see the details section); if
omitted, the function will search, as if the name of the object
appeared in unquoted in an expression.
\item[\code{envir}] an alternative way to specify an environment to look in,
but it's usually simpler to just use the \code{where} argument.
\item[\code{frame}] a frame in the calling list.  Equivalent to giving \code{where}
as \code{sys.frame(frame)}.
\item[\code{mode}] the mode of object sought.
\item[\code{inherits}] should the enclosing frames of the environment be inspected.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The \code{where} argument can specify the  environment in which to look
for the object in any of several ways:
as an integer (the position in the \code{\Link{search}} list); as
the character string name of an element in the search list; or as an
\code{\Link{environment}} (including using \code{\Link{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.

This function looks to see if the name \code{x} has a value bound to it.
If \code{inherits} is \code{TRUE} and a value is not found for \code{x},
then the parent frames of the environment are searched until the name
\code{x} is encountered.  \bold{Warning:} This is the default behaviour
for \R{} but not for S.

If \code{mode} is specified then only objects of that mode are sought.
The function returns \code{TRUE} if the variable is encountered and
\code{FALSE} if not.

The \code{mode} includes collections such as \code{"numeric"} and
\code{"function"}: any member of the collection will suffice.\end{Details}
\begin{Value}
Logical, true if and only if the object is found on the search path.\end{Value}
\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{\Link{get}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
##  Define a substitute function if necessary:
if(!exists("some.fun", mode="function"))
 some.fun <- function(x) { cat("some.fun(x)\n"); x }
search()
exists("ls", 2) # true even though ls is in pos=3
exists("ls", 2, inherits=FALSE) # false
\end{ExampleCode}
\end{Examples}

