utility_basic_stacktrace

utility_basic_stacktrace (기본 스택트레이스)

이 페이지는 C++23에서 도입된 std::basic_stacktrace 템플릿 클래스에 대해 설명해요. 스택트레이스는 현재 실행 중인 스레드의 함수 호출 시퀀스를 근사적으로 나타내는 자료구조이며, 각 호출 항목은 std::stacktrace_entry로 표현된답니다. 이 페이지에서는 템플릿 매개변수, 멤버 타입, 멤버 함수, 비멤버 함수, 헬퍼 클래스 등을 다루고 있어요.

출처: cppreference

본문

현재 실행 스레드에서의 현재 평가 (\small{ {x}{0} }) 의 호출 시퀀스(invocation sequence)는 (\small{i \ge 0}) 에 대해 (\small{ {x}{i} }) 가 함수 호출 (\small{ {x}{i+1} }) 내에 있는 평가들의 시퀀스 (\small{ ({x}{0}, \dots, {x}_{n})}) 이에요.

스택트레이스는 호출 시퀀스의 근사적 표현이며, 스택트레이스 항목(entries)들로 구성돼요.

스택트레이스 항목은 스택트레이스에서 하나의 평가를 나타내며, C++ 표준 라이브러리에서는 std::stacktrace_entry로 표현된답니다.

템플릿 매개변수

멤버 타입

멤버 함수

비멤버 함수

헬퍼 클래스

참고 사항

사용자 정의 할당자 지원은 핫 경로(hot path)나 임베디드 환경에서 basic_stacktrace를 사용할 수 있도록 제공돼요. 사용자는 stacktrace_entry 객체를 스택이나 적절한 다른 장소에 할당할 수 있답니다.

std::basic_stacktrace가 소유한 std::stacktrace_entry 객체들의 시퀀스는 불변이며, 비어 있거나 전체 스택트레이스의 연속된 구간을 나타내요.

std::basic_stacktrace를 사용할 수 없을 때는 boost::stacktrace::basic_stacktrace(Boost.Stacktrace에서 제공)를 대신 사용할 수 있어요.

예제

Compiler Explorer에서 얻은 출력: msvc 및 gcc.

#include <iostream>
#include <stacktrace>

int nested_func(int c)
{
    std::cout << std::stacktrace::current() << '\n';
    return c + 1;
}

int func(int b)
{
    return nested_func(b + 1);
}

int main()
{
    std::cout << func(777);
}

가능한 출력:

// msvc output (the lines ending with '⤶' arrows are split to fit the width):
0> C:\Users\ContainerAdministrator\AppData\Local\Temp\compiler-explorer-compiler20221122-⤶
31624-2ja1sf.8ytzw\example.cpp(6): output_s!nested_func+0x1F
1> C:\Users\ContainerAdministrator\AppData\Local\Temp\compiler-explorer-compiler20221122-⤶
31624-2ja1sf.8ytzw\example.cpp(12): output_s!func+0x15
2> C:\Users\ContainerAdministrator\AppData\Local\Temp\compiler-explorer-compiler20221122-⤶
31624-2ja1sf.8ytzw\example.cpp(15): output_s!main+0xE
3> D:\a\_work\1\s\src\vctools\crt\vcstartup\src\startup\exe_common.inl(288): output_s!⤶
__scrt_common_main_seh+0x10C
4> KERNEL32!BaseThreadInitThunk+0x14
5> ntdll!RtlUserThreadStart+0x21
779

gcc output:
   0# nested_func(int) at /app/example.cpp:7
   1# func(int) at /app/example.cpp:13
   2#      at /app/example.cpp:18
   3#      at :0
   4#      at :0
   5# 

779

같이 보기

더 알아보기 (Learn more)

cppreference