Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::expected: vrednost ali izrecna napaka

std::expected<T, E> vsebuje natanko eno od dveh stanj: pričakovano vrednost T ali objekt napake E, brez praznega stanja.

Različica: 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> je diskriminirana unija C++23. Uspeh ustvarite iz vrednosti T ali std::in_place, napako pa z std::unexpected(error) ali std::unexpect; has_value() in izrecna pretvorba v bool razlikujeta stanji.

value() vrne vrednost, v stanju napake pa vrže std::bad_expected_access<E>, ki vsebuje napako. error() ne meče, vendar ga smete poklicati le, ko je has_value() false; tudi operator* in operator-> zahtevata stanje vrednosti. Primer varno izpiše 7 ob uspehu in missing ob napaki.

std::expected::operator bool vrne stanje uspeha tako kot has_value(). std::expected::operator* in std::expected::operator-> omogočata nepreverjen dostop do vrednosti in zahtevata stanje uspeha; kršitev tega predpogoja povzroči nedoločeno vedenje. std::expected::error vrne referenco na napako in nasprotno zahteva stanje napake; za preverjen dostop do vrednosti uporabite value(), ki lahko vrže izjemo.

T mora biti void ali popoln nepoljski objektni tip, ki upošteva standardne izključitve; E mora biti nekvalificiran objektni tip, ne polje ali specializacija unexpected. Objekt nikoli ni brez vrednosti, vendar imajo kopiranje, premikanje in monadične operacije lastne tipske omejitve. value_or nadomestni argument ovrednoti pred klicem kot navaden argument funkcije.

Primeri

#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

Viri