std::bad_variant_access
| ヘッダ <variant>
|
||
class bad_variant_access : public std::exception
|
(C++17 以降) で定義される | |
std::bad_variant_access は、以下の状況で送出される例外の型です:
- std::get(std::variant) が、現在アクティブな選択肢と一致しないインデックスまたは型で呼び出された場合。
std::visitが、valueless_by_exceptionである variant に対して訪問(visit)のために呼び出された場合。
|
(C++26 以降) |
メンバー関数
|
(constructor)
|
新しい
bad_variant_access
オブジェクトを構築する
(public member function) |
|
operator=
|
bad_variant_access
オブジェクトを置き換える
(public member function) |
|
what
|
説明文字列を返す
(public member function) |
std::bad_variant_access:: bad_variant_access
|
bad_variant_access
(
)
noexcept
;
|
(1) |
(C++17以降)
(constexpr since C++26) |
|
bad_variant_access
(
const
bad_variant_access
&
other
)
noexcept
;
|
(2) |
(C++17以降)
(constexpr since C++26) |
新しいbad_variant_accessオブジェクトを構築します。実装定義のnull終端バイト文字列が含まれており、
what()
を通じてアクセス可能です。
std::bad_variant_access
を持つ場合、
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
となります。
パラメータ
| other | - | コピーする別の例外オブジェクト |
std::bad_variant_access:: operator=
|
bad_variant_access
&
operator
=
(
const
bad_variant_access
&
other
)
noexcept
;
|
(C++17以降)
(constexpr C++26以降) |
|
other
の内容を代入します。
*
this
と
other
の両方が動的型
std::bad_variant_access
を持つ場合、代入後は
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
となります。
パラメータ
| other | - | 代入する別の例外オブジェクト |
戻り値
* this
std::bad_variant_access:: what
|
virtual
const
char
*
what
(
)
const
noexcept
;
|
(C++17以降)
(constexpr C++26以降) |
|
説明文字列を返します。
戻り値
説明情報を含む実装定義のナル終端文字列へのポインタ。この文字列は std::wstring への変換と表示に適しています。ポインタは、少なくとも取得元の例外オブジェクトが破棄されるまで、または例外オブジェクトの非constメンバ関数(コピー代入演算子など)が呼び出されるまで有効であることが保証されます。
|
定数評価中、返される文字列は通常のリテラルエンコーディングでエンコードされます。 |
(C++26以降) |
注記
実装は
what()
をオーバーライドすることが許可されていますが、必須ではありません。
std::exception から継承 std:: exception
メンバ関数
|
[virtual]
|
例外オブジェクトを破棄
( std::exception の仮想公開メンバ関数)
|
|
[virtual]
|
説明文字列を返す
( std::exception の仮想公開メンバ関数)
|
例
#include <iostream> #include <variant> int main() { std::variant<int, float> v; v = 12; try { std::get<float>(v); } catch (const std::bad_variant_access& e) { std::cout << e.what() << '\n'; } }
出力例:
bad_variant_access
関連項目
|
(C++17)
|
インデックスまたは型(型が一意の場合)を指定してvariantの値を読み取り、エラー時に例外をスローする
(関数テンプレート) |
|
(C++17)
|
1つ以上の
variant
が保持する引数で指定された関数オブジェクトを呼び出す
(関数テンプレート) |
|
(C++26)
|
variant
が保持する引数で指定された関数オブジェクトを呼び出す
(公開メンバ関数) |
|
(C++17)
|
値を含まないoptionalへのチェック付きアクセスを示す例外
(クラス) |
|
(C++23)
|
予期しない値を含む
expected
へのチェック付きアクセスを示す例外
(クラステンプレート) |