CKTIS / C++
std::unexpected — výslovné označenie chybového výsledku
std::unexpected<E> z <expected> obaľuje chybovú hodnotu a umožňuje vytvoriť std::expected<T, E> v chybovom stave. Odlišuje chybu od úspešného výsledku, aj keď T a E sú rovnakého typu.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}std::unexpected<E> je šablóna triedy dostupná od C++23 v <expected>, ktorá uchováva chybovú hodnotu. std::unexpected{error_value} odvodí typ E. Vytvorenie obalu samo osebe nevyvolá výnimku, ale konštruktor uloženého typu E ju vyvolať môže.
std::expected<T, E> uchováva buď výsledok, alebo chybu. Odovzdanie std::unexpected<E> zvolí chybový stav; v príklade by return -1; znamenalo úspešný výsledok typu int, zatiaľ čo return std::unexpected{-1}; znamená neúspech. Toto rozlíšenie funguje aj vtedy, keď sú T a E totožné.
K uloženej chybe možno pristupovať pomocou std::unexpected<E>::error(). Pri std::expected<T, E> najprv skontrolujte stav: if (result) znamená úspech. *result používajte iba pri úspechu a result.error() iba pri neúspechu. V C++23 volanie value() na lvalue vyžaduje, aby sa objekt typu E dal skonštruovať kopírovaním. V chybovom stave result.value() vyvolá výnimku std::bad_expected_access<E>, ak sa ju podarí skonštruovať. Kopírovanie alebo presun chybovej hodnoty typu E pri konštrukcii tejto výnimky však môže vyvolať inú výnimku.
Príklad vyžaduje podporu C++23 v kompilátore aj štandardnej knižnici. Zobrazený kód bol spustený bez zmien v izolovanom prostredí a jeho výstup bol porovnaný s uvedeným výsledkom. Príznak kompilátora v repozitári nepotvrdzuje podporu pri spustení v produkčnom prostredí. Dodaný zdrojový dokument je priebežne upravovaný návrh, nie nemenné vydanie C++23.
Príklady
#include <expected>
#include <initializer_list>
#include <iostream>
std::expected<int, int> half(int n) {
if (n % 2 != 0) {
return std::unexpected{-1};
}
return n / 2;
}
int main() {
for (int n : {8, 7}) {
auto result = half(n);
if (result) {
std::cout << "value: " << *result << '\n';
} else {
std::cout << "error: " << result.error() << '\n';
}
}
}
Výsledok
value: 4 error: -1
Zobrazený kód bol spustený bez zmien v izolovanom prostredí. Jeho štandardný výstup presne zodpovedal uvedenému výsledku.