std::out_of_range

 

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 out_of_range;

定義される範囲外の要素にアクセスしようとした結果として発生するエラーを報告するためにスローされる例外オブジェクトの型。

std::bitset および std::basic_string のメンバ関数、std::stoi および std::stod ファミリの関数、そして境界チェック付きメンバアクセス関数（例: std::vector::at および std::map::at）によってスローされる場合があります。

継承図

メンバ関数

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

std::out_of_range::out_of_range

out_of_range( const std::string& what_arg );	(1)
out_of_range( const char* what_arg );	(2)
out_of_range( const out_of_range& 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::out_of_rangeを持つ場合、 std::strcmp(what(), other.what()) == 0 となります。コピーコンストラクタから例外がスローされることはありません。

パラメータ

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

例外

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

注釈

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

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

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

std::out_of_range::operator=

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

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

パラメータ

その他

-

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

戻り値

*this

注釈

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

std::logic_error から継承

std::exception から継承

メンバ関数

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

注記

標準エラー条件 std::errc::result_out_of_range は、通常、入力ではなく結果が範囲外である状況を示し、 std::range_error および ERANGE により近い関係があります。

不具合報告

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

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

関連項目

at	境界チェック付きで指定された文字にアクセスする (std::basic_string<CharT,Traits,Allocator> の public メンバ関数)
at	境界チェック付きで指定された文字にアクセスする (std::basic_string_view<CharT,Traits> の public メンバ関数)
at	境界チェック付きで指定された要素にアクセスする (std::deque<T,Allocator> の public メンバ関数)
at	境界チェック付きで指定された要素にアクセスする (std::map<Key,T,Compare,Allocator> の public メンバ関数)
at	境界チェック付きで指定された要素にアクセスする (std::unordered_map<Key,T,Hash,KeyEqual,Allocator> の public メンバ関数)
at	境界チェック付きで指定された要素にアクセスする (std::vector<T,Allocator> の public メンバ関数)
at	境界チェック付きで指定された要素にアクセスする (std::array<T,N> の public メンバ関数)
at (C++26)	境界チェック付きで指定された要素にアクセスする (std::span<T,Extent> の public メンバ関数)