最終更新日時(UTC): 2026年02月26日 04時20分38秒
Akira Takahashi が更新

履歴 編集

function
<expected>

# std::expected::operator*(C++23)

    constexpr const T& operator*() const & noexcept;   // (1)
    constexpr T& operator*() & noexcept;               // (2)
    constexpr T&& operator*() && noexcept;             // (3)
    constexpr const T&& operator*() const && noexcept; // (4)

## 概要

正常値を取得する。

## 堅牢化された事前条件

`has_value() == true`

## 戻り値

動作説明用のメンバ変数として、正常値を保持する`val`を導入する。

- (1), (2) : `val`
- (3), (4) : `std::move(val)`

## 例外

投げない

## 例

    #include <expected>
    #include <iostream>
    #include <string>

    int main()
    {
      std::expected<int, std::string> x = 1;
      std::cout << *x << std::endl;

      std::expected<int, std::string> y = std::unexpected{"ERR"};
    //std::cout << *y << std::endl;
      // エラー値を保持する y に対する operator* 呼び出しは未定義動作
    }

### 出力

    1

## バージョン

### 言語

- C++23

### 処理系

- Clang: 16.0 ✅
- GCC: 12.1 ✅
- ICC: ??
- Visual C++: ??

## 関連項目

- `operator->`
- `value()`
- `value_or()`

## 参照

- P0323R12 std::expected
- P3471R4 Standard library hardening
- P3878R1 Standard library hardening should not use the 'observe' semantic