std::unexpected_handler

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

診断ライブラリ

例外処理 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)

 

ヘッダー <exception> で定義
typedef void ( *unexpected_handler )();		(C++11で非推奨) (C++17で削除)

std::unexpected_handler は、関数 std::set_unexpected および std::get_unexpected によってインストールおよび照会され、関数 std::unexpected によって呼び出される、関数ポインタ型（引数なしで void を返す関数へのポインタ）です。

C++ 実装はデフォルトの std::unexpected_handler 関数を提供しており、これは std::terminate() を呼び出します。NULL ポインタ値がインストールされている場合（std::set_unexpected を介して）、実装はデフォルトのハンドラを復元することがあります。

ユーザー定義の std::unexpected_handler は、プログラムを終了するか、例外をスローすることが期待されます。例外をスローした場合、以下の 3 つの状況のいずれかに遭遇する可能性があります。

1) std::unexpected_handler によってスローされた例外は、以前に違反された動的例外指定を満たしています。新しい例外は関数からエスケープすることが許可され、スタック巻き戻しが続行されます。

2) std::unexpected_handler によってスローされた例外は、依然として例外指定を違反しています。

2a) ただし、例外指定が std::bad_exception を許可している場合：スローされた例外オブジェクトは破棄され、代わりに C++ ランタイムによって std::bad_exception が構築されてスローされます。

2b) 例外指定が std::bad_exception を許可していない場合：std::terminate() が呼び出されます。

関連項目

unexpected (C++11で非推奨)(C++17で削除)	動的例外仕様に違反した際に呼び出される関数 (関数)
set_unexpected (C++11で非推奨)(C++17で削除)	std::unexpected によって呼び出される関数を変更する (関数)
get_unexpected (C++11で非推奨)(C++17で削除)	現在の unexpected_handler を取得する (関数)