stop                  package:base                  R Documentation

_S_t_o_p _F_u_n_c_t_i_o_n _E_x_e_c_u_t_i_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     `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.

_U_s_a_g_e:

     stop(message = NULL, call. = TRUE)
     geterrmessage()

_A_r_g_u_m_e_n_t_s:

 message: a character vector (of length 1) or `NULL'.

   call.: logical, indicating if the call should become part of the
          error message.

_D_e_t_a_i_l_s:

     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').

_V_a_l_u_e:

     `geterrmessage' gives the last error message, as character string
     ending in `"\n"'.

_S_e_e _A_l_s_o:

     `warning', `restart' to catch errors and retry, and `options' for
     setting error handlers. `stopifnot' for validity testing.

_E_x_a_m_p_l_e_s:

     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

