std::exception

 

C++

編譯器支援

獨立式與託管式

語言

標準函式庫

標準函式庫標頭檔

具名要求

特性測試巨集 (C++20)

語言支援函式庫

概念函式庫 (C++20)

診斷函式庫

記憶體管理函式庫

元編程函式庫 (C++11)

通用公用程式函式庫

容器函式庫

疊代器函式庫

Ranges 函式庫 (C++20)

演算法函式庫

字串函式庫

文本處理函式庫

數值函式庫

日期與時間函式庫

輸入/輸出函式庫

檔案系統函式庫 (C++17)

並行支援函式庫 (C++11)

執行控制函式庫 (C++26)

技術規範

符號索引

外部函式庫

 

工具程式庫

語言支援 型別支援 (基本型別, RTTI) 函式庫特性測試巨集 (C++20) 程式公用程式 可變參數函式 initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) 協程支援 (C++20) 合約支援 (C++26) 三向比較 three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

通用公用程式 函式物件 位元操作 (C++20) bitset hash (C++11) 關係運算子 (C++20 中棄用) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= 整數比較函式 cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap 與 型別操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 通用詞彙型別 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

診斷函式庫

異常處理 exception 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 斷言 (Assertions) 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)

 

std::exception

成員函式

exception::exception

exception::~exception

exception::operator=

exception::what

 

定義於標頭檔 <exception>
class exception;

提供一致的介面，透過 throw 表達式處理錯誤。

所有由標準程式庫產生的異常皆繼承自 std::exception。

std::exception 的所有成員函式皆為 constexpr。

（C++26 起）

成員函式

(建構子)	建構異常物件 (公開成員函式)
(解構函式) [虛擬]	銷毀異常物件 (虛擬公開成員函式)
operator=	複製異常物件 (公開成員函式)
what [虛擬]	返回說明字串 (虛擬公開成員函式)

標準異常要求

每個繼承自 std::exception 的標準程式庫類別 T 都具有下列可公開存取的成員函式，且每一個 都不會以異常退出(C++11 前)都具有 不拋出異常的規格 (non-throwing exception specification)(C++11 起)

• 預設建構函式 (除非提供了其他建構函式)
• 複製建構函式
• 複製賦值運算子

複製建構函式與複製賦值運算子滿足以下後置條件

• 若兩個物件 lhs 與 rhs 的動態類型皆為 T，且 lhs 是 rhs 的複本，則 std::strcmp(lhs.what(), rhs.what()) 等於 ​0​。

每個該類別 T 的 what() 成員函式皆滿足 std::exception::what() 所指定的約束。

標準異常

• logic_error

• invalid_argument
• domain_error
• length_error
• out_of_range
• future_error (C++11 起)

• runtime_error

• range_error
• overflow_error
• underflow_error
• regex_error (C++11 起)
• system_error (C++11 起)

• ios_base::failure (C++11 起)
• filesystem::filesystem_error (C++17 起)

• tx_exception (TM TS)
• nonexistent_local_time (C++20 起)
• ambiguous_local_time (C++20 起)
• format_error (C++20 起)

• bad_typeid
• bad_cast

• bad_any_cast (C++17 起)

• bad_optional_access (C++17 起)
• bad_expected_access (C++23 起)
• bad_weak_ptr (C++11 起)
• bad_function_call (C++11 起)
• bad_alloc

• bad_array_new_length (C++11 起)

• bad_exception
• ios_base::failure (C++11 前)
• bad_variant_access (C++17 起)

註解

功能測試巨集	數值	標準	功能
__cpp_lib_constexpr_exceptions	202411L	(C++26)	異常類型的 constexpr

缺陷報告

下列更改行為的缺陷報告追溯應用於之前的 C++ 標準。

DR	應用於	出版時的行為	正確的行為
LWG 471	C++98	曾對繼承自 std::exception 的標準程式庫類別沒有任何要求	已新增