prolog_stack:get_prolog

swipl
- library

get_prolog_backtrace(+MaxDepth, -Backtrace) is det

get_prolog_backtrace(+MaxDepth, -Backtrace, +Options) is det

Obtain a backtrace from the current location. The backtrace is a list of frames. Each frame is an opaque term that can be inspected using the predicate prolog_stack_frame_property/2 can be used to extract information from these frames. Most use scenarios will pass the stack to print_prolog_backtrace/2. The following options are provided:

frame(+Frame): Start at Frame instead of the current frame.
goal_term_depth(+Depth): If Depth > 0, include a shallow copy of the goal arguments into the stack. Default is set by the Prolog flag backtrace_goal_depth, set to 3 initially, showing the goal and toplevel of any argument.
guard(+Guard): Do not show stack frames above Guard. See stack_guard/1.
clause_references(+Bool): Report locations as Clause+PC or as a location term that does not use clause references, allowing the exception to be printed safely in a different context.

Arguments:

`Frame`	- is the frame to start from. See prolog_current_frame/1.
`MaxDepth`	- defines the maximum number of frames returned.

Compatibility

- get_prolog_backtrace/3 used to have the parameters +Frame, +MaxDepth, -Backtrace. A call that matches this signature is mapped to

get_prolog_backtrace(MaxDepth, Backtrace,
[frame(Frame)])