traceback                package:base                R Documentation

_P_r_i_n_t _C_a_l_l _S_t_a_c_k _o_f _L_a_s_t _E_r_r_o_r

_D_e_s_c_r_i_p_t_i_o_n:

     'traceback()' prints the call stack of the last error, i.e., the
     sequence of calls that lead to the error.  This is useful when an
     error occurs with an unidentifiable error message. This stack is
     stored as a list in '.Traceback', which 'traceback' prints in a
     user-friendly format.

_U_s_a_g_e:

     traceback()

_V_a_l_u_e:

     'traceback()' returns nothing, but prints the deparsed call stack
     deepest call first.  The calls may print on more that one line,
     and the first line is labelled by the frame number.

_R_e_f_e_r_e_n_c_e_s:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

_E_x_a_m_p_l_e_s:

     foo <- function(x) { print(1); bar(2) }
     bar <- function(x) { x + a.variable.which.does.not.exist }
     ## Don't run: 
     foo(2) # gives a strange error
     traceback()
     ## End Don't run
     ## 2: bar(2)
     ## 1: foo(2)
     bar
     ## Ah, this is the culprit ...

