핵심 요약
C++26 Contracts는 함수 선언에 pre(사전 조건)와 post(사후 조건)를 붙이고, 본문 안에서는 contract_assert로 조건을 검사하는 표준 문법입니다. 기존 assert 매크로와 달리 조건이 선언에 드러나므로 호출자와 도구가 조건을 볼 수 있습니다. 조건이 깨졌을 때의 동작은 평가 의미(semantic)에 따라 달라지며, 어떤 의미를 쓸지는 구현 정의입니다. GCC 14.2는 아직 C++26 Contracts를 지원하지 않습니다(미지원). cppreference 컴파일러 지원 표 기준 GCC 16부터 지원합니다. 이 글은 Hacker News 토론을 계기로 정리했습니다.
C++26 Contracts란 무엇입니까?
한 줄 답: 함수 선언에 pre(호출 전)·post(반환 후)를 붙이고 본문에서는 contract_assert로 조건을 검사하는 표준 문법입니다.
cppreference에 따르면 contract assertion은 함수 계약 지정자(pre, post)와 contract_assert 문으로 이루어지며, 각각 bool 타입의 조건식을 가집니다. 검사 시점은 다음과 같습니다.
pre: 함수 호출 진입 시점의 조건(사전 조건)contract_assert: 본문의 해당 위치에서 검사하는 조건post: 함수가 반환될 때의 조건(사후 조건).post(r: ...)처럼 반환값에 이름을 붙여 쓸 수 있습니다.

아래는 세 가지를 모두 사용한 예제입니다. GCC 14.2에서는 컴파일되지 않는 예제이므로 실행 결과는 없습니다.
#include <cstdio>
int safe_div(int a, int b)
pre(b != 0)
post(r: r * b <= a)
{
contract_assert(a >= 0);
return a / b;
}
int main() { std::printf("%d\n", safe_div(10, 2)); }
assert와 무엇이 다릅니까?
한 줄 답: assert는 <cassert> 매크로로 본문 안에만 있고, Contracts는 선언에 붙는 언어 문법이라 호출자와 도구가 조건을 볼 수 있습니다.
assert는 NDEBUG가 정의되면 아무것도 아닌 것으로 확장되고, 함수 본문 안에 있어서 선언만 봐서는 조건을 알 수 없습니다. 반면 Contracts는 조건이 선언에 붙어 있어 호출하는 쪽과 도구가 같은 조건을 볼 수 있습니다. assert도 매크로라는 점은 expected unqualified-id 에러에서 다룬 매크로 함정과 같은 계열입니다.

지금 쓸 수 있는 assert 방식 예제입니다. g++ -std=c++17 assert_alt.cpp -o assert_alt로 컴파일은 성공했고, 인자 없이 실행하면 먼저 safe_div(10, 2)의 결과 5가 출력되고, 이어서 b = 0인 호출에서 assert 메시지가 stderr에 출력된 뒤 abort(종료 코드 134)했습니다. 아래는 stdout과 stderr를 한 파일로 받아 본 실제 출력입니다.
#include <cassert>
#include <iostream>
int safe_div(int a, int b) {
assert(b != 0 && "b must not be zero"); // C++26 이전 방식
return a / b;
}
int main(int argc, char**) {
std::cout << safe_div(10, 2) << std::endl; // endl로 바로 내보냄
return safe_div(1, argc - 1);
}
$ ./assert_alt
5
assert_alt: assert_alt.cpp:4: int safe_div(int, int): Assertion `b != 0 && "b must not be zero"' failed.
std::endl로 내보냄 이유는 버퍼 때문입니다. 출력이 버퍼에 남아 있는 상태에서 abort로 종료되면 그 출력은 사라질 수 있습니다.
조건이 깨지면 어떻게 됩니까?
한 줄 답: 평가 의미에 따라 무시되거나, 검사 후 위반 처리기가 호출되거나, 종료되며, 어떤 의미를 쓸지는 구현 정의입니다.
cppreference는 평가 의미를 네 가지로 설명합니다. 어떤 의미를 쓸지는 구현 정의이며 평가마다 다를 수 있습니다.
| 평가 의미 | 검사 | 위반 시 (런타임) |
|---|---|---|
ignore | 없음(효과 없음) | 해당 없음 |
observe | 검사함 | 위반 처리기 호출, 반환 후 계속 진행 |
enforce | 검사함 + 종료 | 위반 처리기 호출, 반환 후 contract-terminated |
quick-enforce | 검사함 + 종료 | 처리기 없이 곧바로 contract-terminated |
- 위반은 조건식이
false이거나, 예외로 빠져나오거나, (상수 평가에서) 핵심 상수식이 아닐 때 발생합니다. - 위반 처리기는
::handle_contract_violation(const std::contracts::contract_violation&)입니다. 처리기를 교체할 수 있는지는 구현 정의입니다. - contract-terminated가
std::terminate,std::abort, 실행 중단 중 무엇인지도 구현 정의입니다. - 검사 의미에서도 조건식이 평가되지 않을 수 있으므로 부작용에 의존하면 안 됩니다.
런타임에 잘못된 메모리 접근을 찾는 도구가 필요하다면 AddressSanitizer 글도 참고할 수 있습니다.
지금 컴파일러에서 쓸 수 있습니까?
한 줄 답: GCC 14.2는 미지원이고 cppreference 표 기준 GCC 16부터 지원하므로, 그 전까지는 assert 등으로 대체합니다.
GCC 14.2는 아직 C++26 Contracts를 지원하지 않습니다(미지원). cppreference 컴파일러 지원 표 기준 GCC 16부터 지원합니다. 2026-10-23 KST에 g++ (Debian 14.2.0-19) 14.2.0으로 위 예제를 컴파일한 실제 출력입니다(종료 코드 1).
$ g++ -std=c++26 -c contracts.cpp
contracts.cpp:3:5: error: expected initializer before ‘pre’
3 | pre(b != 0)
| ^~~
contracts.cpp: In function ‘int main()’:
contracts.cpp:9:34: error: ‘safe_div’ was not declared in this scope
9 | int main() { std::printf("%d\n", safe_div(10, 2)); }
| ^~~~~~~~
g++ -std=c++2c -fcontracts -c contracts.cpp도 같은 출력이었습니다. 기능 테스트 매크로도 확인했습니다.
$ echo | g++ -std=c++26 -dM -E -x c++ - | grep -c __cpp_contracts
0
0은 __cpp_contracts 매크로가 정의되지 않았다는 뜻입니다. cppreference에 따르면 지원하는 컴파일러에서는 이 매크로가 202502L(C++26)입니다.
cppreference의 C++26 컴파일러 지원 표(2026-10-23 확인)에서 Contracts(P2900R14) 행에는 GCC 16만 적혀 있고 Clang과 MSVC 칸은 비어 있습니다. 다른 컴파일러의 버전은 추측하지 않습니다.
그때까지는 위의 assert 예제나 직접 만든 검사 함수를 사용하면 됩니다. 선언에 의도를 드러내는 다른 문법이 궁금하다면 C++ explicit 글을 참고할 수 있습니다.
자주 묻는 질문은 무엇입니까?
성능 비용이 있습니까?
평가 의미에 따라 다릅니다. ignore이면 검사하지 않습니다.
예외 대신 쓰는 것입니까?
아닙니다. Contracts는 버그와 가정 위반을 표현하는 것이며, 복구 가능한 오류 처리가 아닙니다. 실패를 값으로 돌려주는 방법은 C++ std::expected 글에서 다루었습니다.
기존 코드는 어떻게 옮깁니까?
지금은 assert를 유지하고, 컴파일러가 지원하면 조건을 pre/post로 옮깁니다.
함께 보면 좋은 글은 무엇입니까?
출처는 어디입니까?
- Hacker News: C++26 Contracts: Introduction to Preconditions and Postconditions (2026-10-15 KST) — 이 글의 계기가 된 토론
- cppreference: Contract assertions (확인 2026-10-23)
- cppreference: Compiler support for C++26 (확인 2026-10-23)
- 직접 측정: g++ (Debian 14.2.0-19) 14.2.0, 2026-10-23 KST