Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::expected: vrijednost ili izričita pogreška

std::expected<T, E> sadrži točno jedno od dva stanja: očekivanu vrijednost T ili objekt pogreške E, bez praznog stanja.

Verzija: C++23

Sintaksa

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> iz <expected> diskriminirana je unija C++23. Uspjeh konstruiraj iz vrijednosti T ili std::in_place, a pogrešku pomoću std::unexpected(error) ili std::unexpect; has_value() i izričita pretvorba u bool razlikuju stanja.

value() vraća vrijednost, a u stanju pogreške baca std::bad_expected_access<E> koji sadrži pogrešku. error() ne baca, ali smije se pozvati samo kada je has_value() false; i operator* te operator-> zahtijevaju stanje vrijednosti. Primjer sigurno ispisuje 7 za uspjeh i missing za pogrešku.

std::expected::operator bool vraća stanje uspjeha jednako kao has_value(). std::expected::operator* i std::expected::operator-> daju neprovjeren pristup vrijednosti i zahtijevaju stanje uspjeha; kršenje tog preduvjeta daje nedefinirano ponašanje. std::expected::error vraća referencu na pogrešku i obratno zahtijeva stanje pogreške; za provjeren pristup vrijednosti koristi value(), koji može baciti iznimku.

T mora biti void ili potpun nepoljski objektni tip koji zadovoljava standardna isključenja; E mora biti nekvalificiran objektni tip, ne polje ni specijalizacija unexpected. Objekt nikada nije bez vrijednosti, ali kopiranje, premještanje i monadske operacije imaju vlastita tipska ograničenja. value_or procjenjuje zamjenski argument prije poziva kao običan argument funkcije.

Primjeri

#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';
}

Rezultat

7 missing

std::expected → 7 missing

Izvori