std::system_error::system_error

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

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

通用工具庫

容器庫

迭代器庫

範圍庫 (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 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 斷言 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::system_error

成員函式

system_error::system_error

system_error::operator=

system_error::code

system_error::what

 

system_error( std::error_code ec );	(1)	(C++11 起)
system_error( std::error_code ec, const std::string& what_arg );	(2)	(C++11 起)
system_error( std::error_code ec, const char* what_arg );	(2)	(C++11 起)
system_error( int ev, const std::error_category& ecat );	(3)	(C++11 起)
system_error( int ev, const std::error_category& ecat,               const std::string& what_arg );	(4)	(C++11 起)
system_error( int ev, const std::error_category& ecat,               const char* what_arg );	(4)	(C++11 起)
system_error( const system_error& other ) noexcept;	(5)	(C++11 起)

構造新的系統錯誤物件。

1) 用錯誤碼 ec 構造。

2) 用錯誤碼 ec 和解釋字串 what_arg 構造。由 what() 返回的字串保證包含 what_arg 作為子字串。

3) 用底層錯誤碼 ev 和關聯的錯誤類別 ecat 構造。

4) 用底層錯誤碼 ev、關聯的錯誤類別 ecat 和解釋字串 what_arg 構造。由 what() 返回的字串保證包含 what_arg 作為子字串（假設它不包含嵌入的空字元）。

5) 複製建構函式。用 other 的內容初始化。如果 *this 和 other 都具有動態型別 std::system_error，則 std::strcmp(what(), other.what()) == 0。

引數

ec	-	錯誤碼
ev	-	與 ecat 關聯的列舉中的底層錯誤碼
ecat	-	錯誤類別
what_arg	-	解釋性字串
其他	-	要複製的另一個 system_error

示例

演示如何從 errno 值建立 system_error 異常。

執行此程式碼

#include <iostream>
#include <system_error>
 
int main()
{
    try
    {
        throw std::system_error(EDOM, std::generic_category(), "FIX ME");
    }
    catch (const std::system_error& ex)
    {
        std::cout << "code:    [" << ex.code() << "]\n"
                     "message: [" << ex.code().message() << "]\n"
                     "what:    [" << ex.what() << "]\n";
    }
}

可能的輸出

code:    [generic:33]
message: [Numerical argument out of domain]
what:    [FIX ME: Numerical argument out of domain]