std::breakpoint는 C++26에 들어갈 기능으로, 소스 코드 안에서 프로그램 실행을 일시적으로 멈추고 디버거에 제어를 넘기도록 요청하는 표준 라이브러리 함수입니다. 이 글에서는 2026-10-28(KST) 기준 cppreference 문서를 바탕으로 <debugging> 헤더의 함수 세 가지(std::breakpoint, std::breakpoint_if_debugging, std::is_debugger_present)와 기존 컴파일러별 기능 대비 차이점, 그리고 g++ (Debian 14.2.0-19) 14.2.0 환경에서의 확인 결과를 정리합니다.

핵심 요약

std::breakpoint는 코드 안에서 직접 실행을 잠시 멈추고 디버거에 제어를 넘기도록 요청하는 C++26 표준 함수입니다. 지금까지는 컴파일러·운영체제마다 __debugbreak, __builtin_debugtrap, asm("int3")처럼 서로 다른 방법을 썼는데, 이를 <debugging> 헤더로 표준화했습니다. 디버거가 붙어 있을 때만 멈추려면 std::breakpoint_if_debugging()을, 디버거가 있는지 확인만 하려면 std::is_debugger_present()를 씁니다. 실제 동작은 구현 정의(implementation-defined)이며, 확인에 사용한 환경의 GCC 14.2에는 아직 이 헤더가 없었습니다.

std::breakpoint란 무엇입니까?

한 줄 답: std::breakpoint는 프로그램을 종료하지 않고 실행을 일시 정지해 디버거로 제어를 넘기도록 코드 안에서 요청하는 C++26 표준 함수입니다.

cppreference의 std::breakpoint 문서에 따르면, 이 함수는 디버거의 존재 여부를 감지할 수 있는지와 관계없이 프로그램 실행을 일시적으로 멈추고 디버거에 제어를 넘기려고 시도하는 무조건 브레이크포인트(unconditional breakpoint)입니다. 이 함수의 구체적인 동작은 구현 정의(implementation-defined)입니다.

일반적으로 IDE나 디버거에서 줄 번호에 브레이크포인트를 걸어 두는 방식과 달리, 코드 안에서 직접 브레이크포인트를 호출하면 프로그램을 종료하지 않으면서도 디버거 UI만으로는 지정하기 까다로운 런타임 조건(예: 치명적이지 않지만 드물게 발생하는 상태가 감지되었을 때)에 맞춰 멈춤 지점을 제어할 수 있습니다.

한편 실행 중 메모리 오류를 찾아내는 런타임 도구는 이와 역할이 다르며 AddressSanitizer, 메모리 오류를 실행 중에 찾는 법 글에서 다룹니다. 또한 함수의 조건을 contract_assert로 명시하는 C++26 기능은 C++26 Contracts란? pre·post·contract_assert로 함수 조건을 검사할 때 글에서 별도로 확인할 수 있습니다.

<debugging> 헤더에는 무엇이 있습니까?

한 줄 답: 무조건 멈춤을 요청하는 breakpoint(), 디버거가 있을 때만 멈추는 breakpoint_if_debugging(), 디버거 연결 여부를 확인하는 is_debugger_present() 세 가지 noexcept 함수가 들어 있습니다.

cppreference의 <debugging> 헤더 시놉시스에는 std 이름공간 아래에 다음 세 가지 함수가 선언되어 있습니다.

  • void breakpoint() noexcept;
  • void breakpoint_if_debugging() noexcept;
  • bool is_debugger_present() noexcept;

std::breakpoint_if_debugging()은 조건부 브레이크포인트로, 디버거가 존재한다고 판단할 수 있을 때만 디버거로 멈추며 그렇지 않으면 아무 동작도 하지 않습니다(acts as a no-op). 형식적으로는 구현 정의 동작이지만 의미상 if (std::is_debugger_present()) std::breakpoint();와 동등합니다. std::is_debugger_present()는 프로그램이 현재 디버거의 제어 아래에서 실행 중인지 확인해 bool을 반환합니다.

함수역할디버거가 없을 때
std::breakpoint() noexcept디버거 감지 여부와 관계없이 실행 일시 정지 및 디버거 제어 전달 시도구현 정의 (implementation-defined)
std::breakpoint_if_debugging() noexcept디버거가 있다고 판단될 때만 멈춤 (if (std::is_debugger_present()) std::breakpoint();와 동등)아무 동작 안 함 (no-op)
std::is_debugger_present() noexcept프로그램이 디버거 제어 아래에서 실행 중인지 확인 (bool 반환)디버거 연결 여부를 반환 (bool)

debugging-funcs-ko

또한 시놉시스에는 이 세 함수가 모두 // all freestanding으로 표시되어 있어, 표준 차원에서 완전한 운영체제 없이 동작하는 freestanding 구현(임베디드 환경 등)에서도 제공하도록 명시되어 있습니다.

기존 방법과 무엇이 다릅니까?

한 줄 답: 컴파일러와 플랫폼마다 달랐던 __builtin_debugtrap, DebugBreak(), __debugbreak, asm("int3") 같은 비표준 기능을 하나의 표준 인터페이스로 통합해 이식성을 높입니다.

지금까지 C++ 코드 안에서 디버거 브레이크포인트를 걸려면 환경마다 서로 다른 비표준 확장이나 API를 호출해야 했습니다. cppreference는 std::breakpoint가 표준화한 기존 기능으로 다음 예시들을 꼽습니다.

  • __builtin_debugtrap (LLVM)
  • DebugBreak() (Win32 API)
  • __debugbreak (MSVC 확장)
  • asm("int3") (x86 환경의 GCC/clang)

C++26에서는 이를 <debugging> 헤더로 통일하고 기능 테스트 매크로(feature-test macro)로 __cpp_lib_debugging을 제공합니다. 이처럼 플랫폼별 브레이크포인트 기능을 표준 헤더로 통합하는 C++26 설계는 2026-10-17(KST) Hacker News의 “C++26: The New Debugging Header” 스레드에서도 소개되었습니다.

before-after-ko

지금 바로 쓸 수 있습니까?

한 줄 답: C++26 표준은 아직 ISO에서 정식 발행되기 전이며, 확인에 사용한 환경의 GCC 14.2에도 아직 <debugging> 헤더가 없었으므로 __has_include와 __cpp_lib_debugging으로 분기해 사용합니다.

C++26 표준은 아직 ISO에 의해 정식 발행되지 않았습니다. 실제로 2026-10-28(KST) g++ (Debian 14.2.0-19) 14.2.0 환경에서 아래의 breakpoint.cpp 파일을 작성해 확인해 보았습니다.

breakpoint.cpp:

#include <debugging>
int main() { std::breakpoint_if_debugging(); }

이 파일을 $ g++ -std=c++26 -c breakpoint.cpp 명령으로 컴파일하면 종료 코드 1(exit=1)과 함께 다음 출력이 나옵니다.

breakpoint.cpp:1:10: fatal error: debugging: No such file or directory
    1 | #include <debugging>
      |          ^~~~~~~~~~~
compilation terminated.

이 환경의 GCC 14.2에는 아직 <debugging> 헤더가 없었습니다. 따라서 헤더와 라이브러리가 준비되지 않은 환경을 함께 고려할 때는 아래의 실행하지 않은 개념 코드처럼 __has_include(<debugging>)와 __cpp_lib_debugging 기능 테스트 매크로로 확인한 뒤 대체 경로를 두는 패턴을 쓸 수 있습니다.

실행하지 않은 개념 코드:

#if defined(__has_include)
#  if __has_include(<debugging>)
#    include <debugging>
#  endif
#endif

void check_state(bool rare_condition) {
#if defined(__cpp_lib_debugging)
    if (rare_condition) std::breakpoint_if_debugging();
#else
    (void)rare_condition; // 헤더가 없으면 기존 방법(컴파일러별 확장)으로 대체
#endif
}

자주 묻는 질문은 무엇입니까?

한 줄 답: assert와의 프로그램 종료 여부 차이, 디버거가 없을 때의 동작 정의, 그리고 리눅스 gdb 환경에서의 분석 참고 글을 정리했습니다.

assert와는 무엇이 다릅니까?

assert는 조건이 거짓일 때(NDEBUG가 정의되지 않은 빌드에서) 프로그램을 중단(abort)시켜 종료하지만, std::breakpoint는 프로그램을 끝내지 않고 실행을 잠시 멈춰 디버거에 제어를 넘기도록 요청한다는 점이 다릅니다.

디버거 없이 실행하면 어떻게 됩니까?

std::breakpoint_if_debugging()은 디버거가 연결되어 있지 않으면 아무 일도 하지 않습니다(no-op). 반면 std::breakpoint()는 디버거 유무와 상관없이 멈춤을 시도하며 구체적인 동작은 구현 정의(implementation-defined)로 규정되어 있습니다.

gdb에서는 어떻게 확인합니까?

리눅스 환경에서 gdb, core dump, gdbserver로 중단 지점과 상태를 확인하는 실전 절차는 임베디드 리눅스에서 gdb로 크래시 원인은 어떻게 찾나? core dump·gdbserver 실전 글을 참고할 수 있습니다.

함께 보면 좋은 글은 무엇입니까?

한 줄 답: 리눅스 gdb 디버깅, AddressSanitizer 런타임 메모리 검사, C++26 Contracts를 다룬 글입니다.

출처는 어디입니까?

한 줄 답: Hacker News 스레드와 cppreference의 C++26 <debugging> 헤더 및 함수 문서를 참고했습니다.