Namespaces
Variants

std:: bad_optional_access

From cppreference.net
C++
Utilities library
std::optional
定義於ヘッダ <optional>
class bad_optional_access : public std:: exception
(C++17以降)

値が含まれていないoptionalオブジェクトにアクセスした際に std::optional::value によってスローされるオブジェクトの型を定義します。

std::bad_optional_accessのすべてのメンバー関数は std::bad_optional_access constexpr です：定数式の評価中に std::bad_optional_access オブジェクトを作成して使用することが可能です。

しかしながら、 std::bad_optional_access オブジェクトは一般的に constexpr にはなりません。なぜなら、動的に割り当てられたストレージはすべて同じ定数式の評価中に解放されなければならないからです。

(C++26以降)
cpp/error/exception std-bad optional access-inheritance-lwg2806.svg

継承図

目次

メンバー関数

(コンストラクタ)
新しい bad_optional_access オブジェクトを構築する
(公開メンバ関数)
operator=
bad_optional_access オブジェクトを置き換える
(公開メンバ関数)
what
説明文字列を返す
(公開メンバ関数)

std::bad_optional_access:: bad_optional_access

bad_optional_access ( ) noexcept ;
(1) (C++17以降)
(constexpr C++26以降)
bad_optional_access ( const bad_optional_access & other ) noexcept ;
(2) (C++17以降)
(constexpr C++26以降)

bad_optional_access オブジェクトを構築します。実装定義のヌル終端バイト文字列を持ち、 what() を通じてアクセス可能です。

1) デフォルトコンストラクタ。
2) コピーコンストラクタ。 * this と other の両方が動的型 std::bad_optional_access を持つ場合、 std:: strcmp ( what ( ) , other. what ( ) ) == 0 となります。

パラメータ

other - コピーする別の例外オブジェクト

std::bad_optional_access:: operator=

bad_optional_access & operator = ( const bad_optional_access & other ) noexcept ;
(C++17以降)
(constexpr C++26以降)

other の内容を代入します。 * this と other の両方が動的型 std::bad_optional_access を持つ場合、代入後は std:: strcmp ( what ( ) , other. what ( ) ) == 0 となります。

パラメータ

other - 代入する別の例外オブジェクト

戻り値

* this

std::bad_optional_access:: what

virtual const char * what ( ) const noexcept ;
(C++17以降)
(constexpr C++26以降)

説明文字列を返します。

戻り値

説明情報を含む実装定義のナル終端文字列へのポインタ。この文字列は std::wstring への変換と表示に適しています。ポインタは、少なくとも取得元の例外オブジェクトが破棄されるまで、または例外オブジェクトの非constメンバ関数（コピー代入演算子など）が呼び出されるまで有効であることが保証されます。

定数評価中、返される文字列は通常のリテラルエンコーディングでエンコードされます。

(C++26以降)

注記

実装は what() をオーバーライドすることが許可されていますが、必須ではありません。

std::exception から継承

メンバ関数

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

注記

機能テスト マクロ 値 標準 機能
__cpp_lib_constexpr_exceptions 202502L (C++26) constexpr std::bad_optional_access

例

このコードを実行 
#include <iostream>
#include <optional>
int main()
{
    std::optional<int> opt; // 空のoptionalを作成
    try
    {
        [[maybe_unused]] auto x = opt.value(); // 例外をスロー
    {
    catch (const std::bad_optional_access& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

出力例: 

bad optional access

関連項目

(C++23)
予期しない値が含まれている expected へのチェック付きアクセスを示す例外
(クラステンプレート)
(C++17)
variant の値への不正なアクセス時にスローされる例外
(クラス)