C++23 新利器：深入解析栈踪迹库 (P0881R7)

-   **源文件名**: `source_file()`
-   **源文件行号**: `source_line()`
-   **函数名 (可能经过修饰)**: `description()` (通常包含函数签名)
-   **原生句柄 (实现定义)**: `native_handle()`std::basic_stacktrace<Allocator>: 表示一个栈踪迹，即 std::stacktrace_entry 的集合。它是一个模板类，允许用户自定义内存分配器。标准库也提供了别名 std::stacktrace，使用默认的分配器。

-   **获取当前栈踪迹**: `static std::basic_stacktrace current(const Allocator& alloc = Allocator())`
-   **获取当前栈踪迹 (跳过指定数量的帧)**: `static std::basic_stacktrace current(size_t skip, const Allocator& alloc = Allocator())`
-   **迭代器**: 提供了 `begin()`, `end()`, `rbegin()`, `rend()` 等迭代器，方便遍历栈帧。
-   **大小**: `size()` 返回栈帧的数量。
-   **索引访问**: `operator[]` 允许按索引访问栈帧。
-   **转换为字符串**: `to_string()` 方法可以将整个栈踪迹转换为易于阅读的字符串。

#include <iostream>
#include <stacktrace> // 引入 C++23 栈踪迹库

void bar(int x) {
    std::cout << "Current stack trace in bar():\n";
    // 获取当前栈踪迹
    std::stacktrace st = std::stacktrace::current();
    std::cout << st << "\n"; // 使用默认的 ostream 输出

    // 或者手动迭代
    for (const auto& frame : st) {
        std::cout << "  " << frame.description()
                  << " [" << frame.source_file() << ":" << frame.source_line() << "]\n";
    }
}

void foo(int y) {
    bar(y * 2);
}

int main() {
    std::cout << "Starting main...\n";
    foo(10);
    std::cout << "Exiting main.\n";
    return 0;
}

Starting main...
Current stack trace in bar():
0# bar(int) at /path/to/your/source.cpp:8
1# foo(int) at /path/to/your/source.cpp:17
2# main at /path/to/your/source.cpp:22
3# ... (系统调用相关的帧)

  bar(int) [source.cpp:8]
  foo(int) [source.cpp:17]
  main [source.cpp:22]
  ...
Exiting main.

#include <iostream>
#include <stacktrace>
#include <stdexcept>
#include <string>

class traceable_error : public std::runtime_error {
public:
    traceable_error(const std::string& what_arg)
        : std::runtime_error(what_arg), trace_(std::stacktrace::current(1)) {} // 跳过 traceable_error 构造函数本身

    const std::stacktrace& trace() const noexcept {
        return trace_;
    }

private:
    std::stacktrace trace_;
};

void function_c() {
    throw traceable_error("Something went wrong in function_c!");
}

void function_b() {
    function_c();
}

void function_a() {
    function_b();
}

int main() {
    try {
        function_a();
    } catch (const traceable_error& e) {
        std::cerr << "Caught an exception: " << e.what() << "\n";
        std::cerr << "Stack trace:\n" << e.trace() << "\n";
    } catch (const std::exception& e) {
        std::cerr << "Caught a standard exception: " << e.what() << "\n";
    }
    return 0;
}