Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje