| stop {base} | R Documentation |
Stop Function Execution
Description
stop stops execution of the current expression, prints the
message given as its argument, then executes an error action.
geterrmessage gives the last error message.
Usage
stop(message = NULL, call. = TRUE)
geterrmessage()
Arguments
message |
a character vector (of length 1) or |
call. |
logical, indicating if the call should become part of the error message. |
Details
The error action is controlled by the current error handler set by
options(error=). The default behaviour (the NULL
error-handler) in interactive use is
to return to the top level prompt, and in non-interactive use to
(effectively) call q("no", status=1, runLast=FALSE).
Value
geterrmessage gives the last error message, as character string
ending in "\n".
See Also
warning, restart to catch errors and retry,
and options for setting error handlers.
stopifnot for validity testing.
Examples
options(error = expression(NULL))# don't stop on stop(.) << Use with CARE! >>
iter <- 12
if(iter > 10) stop("too many iterations")
tst1 <- function(...) stop("dummy error")
tst1(1:10,long,calling,expression)
tst2 <- function(...) stop("dummy error", call. = FALSE)
tst2(1:10,long,calling,expression,but.not.seen.in.Error)
options(error = NULL)# revert to default