std::runtime_error

 

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)

 

ヘッダー <stdexcept> で定義
class runtime_error;

例外としてスローされるオブジェクトの型を定義します。プログラムのスコープを超えた、容易に予測できないイベントに起因するエラーを報告します。

継承図

std::runtime_error 型の例外は、以下の標準ライブラリコンポーネントによってスローされます。

• std::locale::locale
• std::locale::combine

std::chrono::current_zone std::chrono::get_tzdb_list std::chrono::get_tzdb std::chrono::locate_zone std::chrono::reload_tzdb std::chrono::remote_version std::chrono::tzdb::locate_zone

(C++20以降)

さらに、以下の標準例外型は std::runtime_error から派生しています。

• std::range_error
• std::overflow_error
• std::underflow_error

std::ios_base::failure std::regex_error std::system_error

(C++11以降)

std::filesystem::filesystem_error

(C++17以降)

std::chrono::ambiguous_local_time std::chrono::nonexistent_local_time std::format_error

(C++20以降)

メンバー関数

(コンストラクタ)	指定されたメッセージを持つ新しい runtime_error オブジェクトを構築します。 (public member function)
operator=	runtime_error オブジェクトを置き換えます。 (public member function)

std::runtime_error::runtime_error

runtime_error( const std::string& what_arg );	(1)
runtime_error( const char* what_arg );	(2)
runtime_error( const runtime_error& other );	(3)	(C++11 以降 noexcept)

1) 説明文字列として what_arg を使用して、例外オブジェクトを構築します。構築後、std::strcmp(what(), what_arg.c_str()) == 0 となります。

2) 説明文字列として what_arg を使用して、例外オブジェクトを構築します。構築後、std::strcmp(what(), what_arg) == 0 となります。

3) コピーコンストラクタ。 *this と other が両方とも動的型 std::runtime_error を持つ場合、 std::strcmp(what(), other.what()) == 0 となります。コピーコンストラクタから例外がスローされることはありません。

パラメータ

what_arg	-	説明文字列
その他	-	コピーする別の例外オブジェクト

例外

1,2) std::bad_alloc をスローする可能性があります。

注釈

std::runtime_error のコピーは例外をスローすることが許可されていないため、このメッセージは通常、内部的に別途割り当てられた参照カウント文字列として格納されます。これは、std::string&& を取るコンストラクタがない理由でもあります。いずれにしても内容をコピーする必要があるからです。

LWG issue 254 の解決前は、非コピーコンストラクタは std::string のみを受け入れることができました。これにより、std::string オブジェクトを構築するために動的割り当てが必須となりました。

LWG issue 471 の解決後、派生標準例外クラスは公開アクセス可能なコピーコンストラクタを持つ必要があります。what() によって取得される説明文字列が元のオブジェクトとコピーされたオブジェクトで同じである限り、暗黙的に定義することができます。

std::runtime_error::operator=

runtime_error& operator=( const runtime_error& other );		(C++11 以降 noexcept)

other の内容で自身の内容を代入します。 *this と other が両方とも動的型 std::runtime_error を持つ場合、代入後には std::strcmp(what(), other.what()) == 0 となります。コピー代入演算子から例外がスローされることはありません。

パラメータ

その他

-

割り当てる別の例外オブジェクト

戻り値

*this

注釈

LWG issue 471 の解決後、派生標準例外クラスは公開アクセス可能なコピー代入演算子を持つ必要があります。what() によって取得される説明文字列が元のオブジェクトとコピーされたオブジェクトで同じである限り、暗黙的に定義することができます。

std::exception から継承

メンバ関数

(デストラクタ) [virtual]	例外オブジェクトを破棄する (std::exception の仮想 public メンバー関数)
what [virtual]	説明文字列を返す (std::exception の仮想 public メンバー関数)

不具合報告

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

DR	適用対象	公開された動作	正しい動作
LWG 254	C++98	const char* を受け入れるコンストラクタが欠落していた	追加された
LWG 471	C++98	std::runtime_error の説明文字列 コピーは実装定義であった	それらは元の std::domain_error オブジェクトと 元の std::runtime_error オブジェクト