std::terminate

 

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> で定義
void terminate();		(C++11まで)
[[noreturn]] void terminate() noexcept;		(C++11以降)

std::terminate() は、プログラムがいずれかの理由で継続できなくなった場合に C++ ランタイムによって呼び出されます。

1) 例外がスローされ、キャッチされなかった場合（この場合、スタックの巻き戻しが行われるかどうかは実装定義です）。

2) まだキャッチされていない例外を処理中に、例外処理メカニズムによって直接呼び出された関数が例外をスローして終了した場合（例：ローカルオブジェクトのデストラクタ、または catch 節のパラメータを構築するコピーコンストラクタ）。

3) 静的またはスレッドローカル(C++11 以降)オブジェクトのコンストラクタまたはデストラクタが例外をスローした場合。

4) std::atexit または std::at_quick_exit(C++11 以降) で登録された関数が例外をスローした場合。

5) 動的例外指定に違反し、std::unexpected のデフォルトハンドラが実行された場合。 6) std::unexpected の非デフォルトハンドラが、以前に違反された動的例外指定に違反する例外をスローした場合（ただし、その指定に std::bad_exception が含まれていない場合）。

(C++17まで)

7) noexcept 指定に違反した場合（この場合、スタックの巻き戻しが行われるかどうかは実装定義です）。 8) キャプチャされた例外を保持していないオブジェクトに対して std::nested_exception::rethrow_nested が呼び出された場合。 9) std::thread の初期関数から例外がスローされた場合。 10) join 可能な std::thread が破棄されたり、代入されたりした場合。 11) std::condition_variable::wait、std::condition_variable::wait_until、または std::condition_variable::wait_for が事後条件を満たせなかった場合（例：ミューテックスの再ロックが例外をスローした場合）。

(C++11以降)

12) 並列アルゴリズムによって呼び出された関数が未キャッチの例外で終了し、実行ポリシーが終了を指定している場合。

(C++17以降)

std::terminate() は、プログラムから直接呼び出されることもあります。

スローされた例外が原因で std::terminate が呼び出された場合、暗黙的な try/catch ハンドラがアクティブであるとみなされます。したがって、std::current_exception を呼び出すと、スローされた例外が返されます。

いずれの場合も、std::terminate は現在インストールされている std::terminate_handler を呼び出します。デフォルトの std::terminate_handler は std::abort を呼び出します。

スタック巻き戻しの最中にデストラクタが terminate ハンドラをリセットし、その後、巻き戻しによって terminate が呼び出された場合、スロー式が終了した時点でインストールされていたハンドラが呼び出されるハンドラとなります。（注：再スローが新しいハンドラに適用されるかどうかは曖昧でした）	(C++11まで)
スタック巻き戻しの最中にデストラクタが terminate ハンドラをリセットした場合、その後、巻き戻しによって terminate が呼び出された場合にどのハンドラが呼び出されるかは未規定です。	(C++11以降)

注釈

ハンドラメカニズムが不要な場合、例えばアトミック操作が必要でバイナリサイズが肥大化する可能性があるため、プログラムを異常終了させる際には std::abort への直接呼び出しが推奨されます。

一部のコンパイラ組み込み関数（例：__builtin_trap (gcc, clang, icc) または __debugbreak (msvc)）は、プログラムを可能な限り速く終了するために使用できます。

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 2111	C++11	スタック巻き戻し中に std::set_terminate を呼び出した効果が C++98 と異なり、一部の ABI を壊します。 unwinding differs from C++98 and breaks some ABIs	未規定になった

関連項目

terminate_handler	std::terminate によって呼び出される関数の型 (typedef)
abort	（クリーンアップせずに）異常なプログラム終了を引き起こす (関数)
breakpoint (C++26)	呼び出された際に実行中のプログラムを一時停止させる (関数)