The R Project SVN R

\name{stop}
\title{Stop Function Execution}
\usage{
stop(message)
}
\alias{stop}
\arguments{
    \item{message}{a character vector (of length 1) or \code{NULL}.}
}
\description{
    \code{stop} stops execution of the current expression, prints the
    message given as its argument, then executes an error action.
}
\details{
    The error action is controlled by the current error handler set by
    \code{options(error=)}. The default behaviour  (the \code{NULL}
    error-handler) in interactive use is
    to return to the top level prompt, and in non-interactive use to
    (effectively) call \code{q("no", status=1, runLast=FALSE}).
}
\seealso{
\code{\link{warning}}, \code{\link{restart}} to catch errors and retry,
and  \code{\link{options}} for setting error handlers.
}
\examples{
\testonly{iter <- 9 #-don't want a stop(.) below!}
if(iter > 10) stop("too many iterations")
}
\keyword{environment}
\keyword{programming}