stack_trace() [7/9]

xtd::diagnostics::stack_trace::stack_trace	(	size_t	skip_frames,
		bool	need_file_info
	)

Initializes a new instance of the xtd::diagnostics::stack_trace class from the caller's frame, skipping the specified number of frames and optionally capturing source information.

Parameters

skip_frames	The number of frames up the stack from which to start the trace.
need_file_info	true to capture the file name, line number, and column number; otherwise, false.

Examples

The following code example displays the first and last function calls in a stack trace.

void Level_5_method() {
  try {
    class_level_6 nested_class;
    nested_class.level_6_method();
  } catch (const exception& e) {
    console::write_line(" Level_5_method exception handler");
 
    stack_trace st;
 
    // Display the most recent function call.
    stack_frame sf = st.get_frame(0);
    console::write_line();
    console::write_line("  Exception in method: ");
    console::write_line("      {}", sf.get_method());
 
    if (st.frame_count() >1) {
      // Display the highest-level function call
      // in the trace.
      sf = st.get_frame(st.frame_count() - 1);
      console::write_line("  Original function call at top of call stack):");
      console::write_line("      {}", sf.get_method());
    }
 
    console::write_line();
    console::write_line("   ... throwing exception to next level ...");
    console::write_line("-------------------------------------------------\n");
    throw;
  }
}

Remarks

If the number of frames to skip is greater than or equal to the total number of frames on the call stack at the time the instance is created, the xtd::diagnostics::stack_trace will contain no frames.