Learn R Programming

growR (version 1.3.0)

browse: Debugging utilities

Description

Debug specified function func by entering a browser() right at the beginning (browse()) or end (browse_end()) of the function.

Usage

browse(func, ...)

browse_end(func, ...)

Value

Returns the result of func(...). Enters a browser().

Arguments

func

An R function to be browsed.

...

Arguments to the function func that is to be browsed.

Functions

  • browse_end(): Enter browser() at the end of the function call to func(...). This only works, if the function can execute without error until its end. Otherwise, the error will be thrown.

Details

These are convenience shorthands for R's builtin debug tools, like debugonce() and the trace()/untrace() combination.

See Also

Examples

Run this code
if (FALSE) { # interactive()
# Define a simple function for this example
my_func = function(a) { for (i in 1:5) { a = a + i }; return(a) }

# Enter a browser at the beginning of the function
browse(my_func, 0)

# Enter a browser at the end of the function. This allows us to inspect 
# the function's local variables without having to go through the whole loop.
browse_end(my_func, 0)
}

Run the code above in your browser using DataLab