\HeaderA{args}{Argument List of a Function}{args}
\keyword{documentation}{args}
\begin{Description}\relax
Displays the argument names and corresponding default values of a
function or primitive.
\end{Description}
\begin{Usage}
\begin{verbatim}
args(name)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{name}] a function (a closure or a primitive).
If \code{name} is a character string then the function with that
name is found and used.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This function is mainly used interactively to print the argument list
of a function.  For programming, consider using \code{\LinkA{formals}{formals}}
instead.
\end{Details}
\begin{Value}
For a closure, a closure with identical formal argument list but an
empty (\code{NULL}) body.

For a primitive, a closure with the documented usage and \code{NULL}
body.  Note that in almost all cases primitives do not make use of
named arguments and match by position rather than name.  (\code{rep}
and \code{seq.int} are exceptions.)

\code{NULL} in case of a non-function.
\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{\LinkA{formals}{formals}},
\code{\LinkA{help}{help}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
args(c)
args(graphics::plot.default)
\end{ExampleCode}
\end{Examples}

