browser                 package:base                 R Documentation

_E_n_v_i_r_o_n_m_e_n_t _B_r_o_w_s_e_r

_D_e_s_c_r_i_p_t_i_o_n:

     Interrupt the execution of an expression and allow the inspection
     of the environment where 'browser' was called from.

_U_s_a_g_e:

     browser()

_D_e_t_a_i_l_s:

     A call to 'browser' causes a pause in the execution of the current
     expression and runs a copy of the R interpreter which has access
     to variables local to the environment where the call took place.

     Local variables can be listed with 'ls', and manipulated with R
     expressions typed to this sub-interpreter.  The sub-interpreter
     can be exited by typing 'c'.  Execution then resumes at the
     statement following the call to 'browser'.

     Typing 'n' causes the step-through-debugger, to start and it is
     possible to step through the remainder of the function one line at
     a time.  In this mode 'c' will continue to the end of the current
     context (to the next loop iteration if within a loop).

     Typing 'Q' quits the current execution and returns you to the
     top-level prompt.

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

     Chambers, J. M. (1998) _Programming with Data. A Guide to the S
     Language_. Springer.

_S_e_e _A_l_s_o:

     'debug', and 'traceback' for the stack on error.

