get_frame()

const xtd::diagnostics::stack_frame & xtd::diagnostics::stack_trace::get_frame ( size_t  index )

noexcept

Gets the specified stack frame.

Parameters

index

The index of the stack frame requested.

Returns

The specified stack frame.

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

Stack frames are numbered starting at 0, which is the last stack frame pushed.

Examples

stack_trace_simple.cpp.