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