Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::expected: wartość albo jawny błąd

std::expected<T, E> przechowuje dokładnie jeden z dwóch stanów: oczekiwaną wartość T albo obiekt błędu E, bez stanu pustego.

Wersja: C++23

Składnia

template<class T, class E>
class expected {
public:
    constexpr explicit operator bool() const noexcept;
    constexpr T* operator->() noexcept;
    constexpr T& operator*() & noexcept;
    constexpr T& value() &;
    constexpr E& error() & noexcept;
    template<class U> constexpr T value_or(U&& fallback) const &;
};

std::expected<T, E> z <expected> jest unią rozłączną C++23. Sukces konstruuje się wartością T lub std::in_place, a błąd przez std::unexpected(error) albo std::unexpect; has_value() i jawna konwersja do bool rozróżniają stany.

value() zwraca przechowywaną wartość, a w stanie błędu rzuca std::bad_expected_access<E> zawierający błąd. error() nie rzuca, ale wolno go wywołać tylko wtedy, gdy has_value() jest false; podobnie operator* i operator-> wymagają stanu wartości. Przykład bezpiecznie drukuje 7 dla sukcesu i tekst missing dla błędu.

std::expected::operator bool zwraca stan sukcesu tak samo jak has_value(). std::expected::operator* i std::expected::operator-> dają niekontrolowany dostęp do wartości i wymagają stanu sukcesu; naruszenie tego warunku wstępnego ma niezdefiniowane zachowanie. std::expected::error daje referencję do błędu i odwrotnie wymaga stanu błędu; do kontrolowanego dostępu do wartości służy value(), które może rzucić.

T musi być void albo kompletnym typem obiektowym niebędącym tablicą i spełniać ograniczenia standardu; E musi być niekwalifikowanym typem obiektowym, nie tablicą ani specjalizacją unexpected. Obiekt nigdy nie jest bezwartościowy, lecz operacje kopiowania, przenoszenia i monadyczne mają własne wymagania typów. value_or nadal oblicza argument zapasowy przed wywołaniem jak zwykły argument funkcji.

Przykłady

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

std::expected<int, std::string> fetch(bool found) {
    if (found) return 7;
    return std::unexpected(std::string{"missing"});
}

int main() {
    const auto good = fetch(true);
    const auto bad = fetch(false);
    std::cout << good.value() << ' ' << bad.error() << '\n';
}

Wynik

7 missing

std::expected → 7 missing

Źródła