診斷庫

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

診斷庫

異常處理 異常 uncaught_exceptionuncaught_exceptions (直至 C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) 異常處理失敗 terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (直到 C++17*) unexpected_handler (直到 C++17*) get_unexpected (直到 C++17*) set_unexpected (直到 C++17*) 錯誤號 錯誤碼 errno 斷言 assert

異常類別 logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) 系統錯誤 error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) 堆疊跟蹤 stacktrace_entry (C++23) basic_stacktrace (C++23) 除錯支援 is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

異常處理

標頭檔案 <exception> 提供了 C++ 程式中與異常處理相關的若干類和函式。

定義於標頭檔案 <exception>
異常	標準庫元件丟擲的異常的基類 (類)
異常物件的捕獲與儲存
uncaught_exceptionuncaught_exceptions (C++20 中移除*)(C++17)	檢查當前是否正在進行異常處理 (函式)
exception_ptr (C++11)	用於處理異常物件的共享指標型別 (typedef)
make_exception_ptr (C++11)	從異常物件建立 std::exception_ptr (函式模板)
current_exception (C++11)	將當前異常捕獲到 std::exception_ptr 中 (函式)
rethrow_exception (C++11)	從 std::exception_ptr 丟擲異常 (函式)
nested_exception (C++11)	用於捕獲和儲存當前異常的 mixin 型別 (類)
throw_with_nested (C++11)	丟擲其引數並混入 std::nested_exception (函式模板)
rethrow_if_nested (C++11)	從 std::nested_exception 丟擲異常 (函式模板)
異常處理失敗的處理
定義於標頭檔案 <exception>
terminate	異常處理失敗時呼叫的函式 (函式)
terminate_handler	由 std::terminate 呼叫的函式型別 (typedef)
get_terminate (C++11)	獲取當前的 terminate_handler (函式)
set_terminate	更改 std::terminate 將呼叫的函式 (函式)
bad_exception	當 std::current_exception 未能複製異常物件時丟擲的異常 (類)
異常規範違規的處理 (直至 C++17)
unexpected (C++11 中已廢棄)(C++17 中已移除)	動態異常規範被違反時呼叫的函式 (函式)
unexpected_handler (C++11 中已廢棄)(C++17 中已移除)	由 std::unexpected 呼叫的函式型別 (typedef)
get_unexpected (C++11 中已廢棄)(C++17 中已移除)	獲取當前的 unexpected_handler (函式)
set_unexpected (C++11 中已廢棄)(C++17 中已移除)	更改 std::unexpected 將呼叫的函式 (函式)

異常類別

標頭檔案 <stdexcept> 中預定義了幾個便利類，用於報告特定的錯誤情況。這些類可分為兩類：邏輯錯誤和執行時錯誤。邏輯錯誤是程式中錯誤邏輯的結果，可能可以預防。執行時錯誤是程式範圍之外的事件造成的，不易預測。

定義於標頭檔案 <stdexcept>
logic_error	表示邏輯前置條件或類不變式違規的異常類 (類)
invalid_argument	報告無效引數的異常類 (類)
domain_error	報告域錯誤的異常類 (類)
length_error	報告嘗試超出最大允許大小的異常類 (類)
out_of_range	報告引數超出預期範圍的異常類 (類)
runtime_error	表示僅在執行時可檢測到的條件的異常類 (類)
range_error	報告內部計算中範圍錯誤的異常類 (類)
overflow_error	報告算術溢位的異常類 (類)
underflow_error	報告算術下溢的異常類 (類)
tx_exception (TM TS)	取消原子事務的異常類 (類模板)

錯誤碼

定義於標頭檔案 <cerrno>
errno	擴充套件為 POSIX 相容的執行緒區域性錯誤碼變數的宏 (宏變數)
E2BIG, EACCES, ..., EXDEV	標準 POSIX 相容錯誤條件的宏 (宏常量)

系統錯誤 (自 C++11 起)

標頭檔案 <system_error> 定義了用於報告源自作業系統、流 I/O、std::future 或其他底層 API 的錯誤情況的型別和函式。

定義於標頭檔案 <system_error>
error_category (C++11)	錯誤類別的基類 (類)
generic_category (C++11)	識別通用錯誤類別 (函式)
system_category (C++11)	標識作業系統錯誤類別 (函式)
error_condition (C++11)	儲存可移植錯誤碼 (類)
errc (C++11)	列舉所有標準 <cerrno> 宏常量的 std::error_condition 列舉 (類)
error_code (C++11)	儲存平臺相關錯誤碼 (類)
system_error (C++11)	用於報告具有 error_code 的情況的異常類 (類)

斷言

斷言有助於實現程式中的前置條件檢查。

定義於標頭檔案 <cassert>
assert	如果使用者指定條件不為 true，則中止程式。在釋出版本中可能會停用。 (函式宏)

棧回溯 (自 C++23 起)

定義於標頭檔案 <stacktrace>
stacktrace_entry (C++23)	棧追蹤中一次求值的表示 (類)
basic_stacktrace (C++23)	由棧追蹤條目組成的近似呼叫序列表示 (類模板)

除錯支援 (自 C++26 起)

定義於標頭檔案 <debugging>
breakpoint (C++26)	呼叫時暫停正在執行的程式 (函式)
breakpoint_if_debugging (C++26)	如果 std::is_debugger_present 返回 true，則呼叫 std::breakpoint (函式)
is_debugger_present (C++26)	檢查程式是否在偵錯程式控制下執行 (函式)

參見

static_assert 宣告 (C++11)	執行編譯時斷言檢查
C 文件 關於 錯誤處理