browser was called from.
browser(text = "", condition = NULL, expr = TRUE, skipCalls = 0L)TRUE the
debugger will invoked, otherwise control is returned directly.browser can be included in the body of a function.
When reached, this causes a pause in the execution of the
current expression and allows access to the R interpreter. The purpose of the text and condition arguments are to
allow helper programs (e.g. external debuggers) to insert specific
values here, so that the specific call to browser (perhaps its location
in a source file) can be identified and special processing can be
achieved. The values can be retrieved by calling browserText
and browserCondition.
The purpose of the expr argument is to allow for the illusion
of conditional debugging. It is an illusion, because execution is
always paused at the call to browser, but control is only passed
to the evaluator described below if expr evaluates to TRUE.
In most cases it is going to be more efficient to use an if
statement in the calling program, but in some cases using this argument
will be simpler.
The skipCalls argument should be used when the browser()
call is nested within another debugging function: it will look further
up the call stack to report its location.
At the browser prompt the user can enter commands or R expressions, followed by a newline. The commands are
c
contc.
nc: see the
documentation for debug. For byte compiled functions
n is equivalent to c.
where
Q
(Leading and trailing whitespace is ignored, except for an empty line).
Anything else entered at the browser prompt is interpreted as an
R expression to be evaluated in the calling environment: in
particular typing an object name will cause the object to be printed,
and ls() lists the objects in the calling frame. (If you want
to look at an object with a name such as n, print it
explicitly.)
The number of lines printed for the deparsed call can be limited by
setting options(deparse.max.lines).
Setting option "browserNLdisabled" to TRUE
disables the use of an empty line as a synonym for c. If this
is done, the user will be re-prompted for input until a valid command
or an expression is entered.
This is a primitive function but does argument matching in the standard way.
Chambers, J. M. (1998) Programming with Data. A Guide to the S Language. Springer.
debug, and
traceback for the stack on error.
browserText for how to retrieve the text and condition.