\Header{menu}{Menu Interaction Function}
\keyword{utilities}{menu}
\keyword{programming}{menu}
\begin{Description}\relax
\code{menu} presents the user with a menu of choices labelled from 1
to the number of choices.  To exit without choosing an item one can
select \samp{0}.\end{Description}
\begin{Usage}
\begin{verbatim}
menu(choices, graphics = FALSE, title = "")
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{choices}] a character vector of choices
\item[\code{graphics}] a logical indicating whether a graphics menu should be
used.  Currently unused.
\item[\code{title}] a character string to be used as the title of the menu
\end{ldescription}
\end{Arguments}
\begin{Value}
The number corresponding to the selected item, or 0 if no choice was
made.\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{Examples}
\begin{ExampleCode}
## Don't run: 
switch(menu(c("List letters", "List LETTERS")) + 1,
       cat("Nothing done\n"), letters, LETTERS)
## End Don't run
\end{ExampleCode}
\end{Examples}

