\Header{get}{Return a Variable's Value}
\keyword{data}{get}
\begin{Usage}
\begin{verbatim}
get(x, pos=-1, envir=pos.to.env(pos), mode="any", inherits=TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{x}] a variable name (given as a quoted string).
\item[\texttt{pos}] position in search list, can be numerical or a quoted string.
\item[\texttt{envir}] the environment to be used.
\item[\texttt{mode}] the type of object sought.
\item[\texttt{inherits}] should the enclosing frames of
the environment be inspected?
\end{ldescription}
\end{Arguments}
\begin{Value}
This function searches the specified environment for a
bound variable whose name is given by the string \texttt{x}.
If the variable's value is not of the correct
\texttt{mode}, it is ignored.

If \texttt{inherits} is \texttt{FALSE}, only the first frame
of the specified environment is inspected.
If \texttt{inherits} is \texttt{TRUE}, the search is continued
up through the parent frames until a bound value of the right
mode is found.

Using a \texttt{NULL} environment is equivalent to using
the current environment.\end{Value}
\begin{SeeAlso}
\texttt{\Link{exists}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
get("%o%")
\end{ExampleCode}
\end{Examples}

