frame_count()

size_t xtd::diagnostics::stack_trace::frame_count ( ) const

noexcept

Gets the number of frames in the stack trace.

Returns

The number of frames in the stack trace.

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 system_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;
  }
}