CKTIS / C++
std::unexpected — výslovné označení chybového výsledku
std::unexpected<E> z <expected> obaluje chybovou hodnotu a umožňuje vytvořit std::expected<T, E> v chybovém stavu. Odlišuje chybu od úspěšného výsledku, i když T a E jsou stejného typu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 šablona třídy dostupná od C++23 v <expected>, která uchovává chybovou hodnotu. std::unexpected{error_value} odvodí typ E. Vytvoření obalu samo o sobě výjimku nevyvolá, ale konstruktor uloženého typu E ji vyvolat může.
std::expected<T, E> uchovává buď výsledek, nebo chybu. Předání std::unexpected<E> zvolí chybový stav; v příkladu by return -1; znamenalo úspěšný výsledek typu int, zatímco return std::unexpected{-1}; znamená neúspěch. Toto rozlišení funguje také tehdy, když jsou T a E totožné.
K uložené chybě lze přistoupit pomocí std::unexpected<E>::error(). U std::expected<T, E> nejprve zkontrolujte stav: if (result) znamená úspěch. *result používejte pouze při úspěchu a result.error() pouze při neúspěchu. V C++23 volání value() na lvalue vyžaduje, aby typ E bylo možné zkonstruovat kopírováním. V chybovém stavu result.value() vyvolá výjimku std::bad_expected_access<E>, pokud se ji podaří zkonstruovat. Kopírování nebo přesun chybové hodnoty typu E při konstrukci této výjimky může místo ní vyvolat jinou výjimku.
Příklad vyžaduje podporu C++23 v kompilátoru i standardní knihovně. Zobrazený kód byl spuštěn beze změn v izolovaném prostředí a jeho výstup byl porovnán s uvedeným výsledkem. Příznak kompilátoru v repozitáři nedokládá podporu za běhu v produkčním prostředí. Dodaný zdrojový dokument je průběžně upravovaný návrh, nikoli neměnné vydání C++23.
Pří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ýsledek
value: 4 error: -1
Zobrazený kód byl spuštěn beze změn v izolovaném prostředí. Jeho standardní výstup přesně odpovídal uvedenému výsledku.