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

CKTIS / C++

std::unexpected — izrecna označitev rezultata z napako

std::unexpected<E> iz <expected> ovije vrednost napake in omogoči konstrukcijo std::expected<T, E> v stanju napake. Tako loči napako od uspešnega rezultata, tudi kadar sta T in E istega tipa.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#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 predloga razreda, ki je v <expected> na voljo od C++23 in hrani vrednost napake. std::unexpected{error_value} izpelje tip E. Ustvarjanje ovoja samo po sebi ne sproži izjeme, lahko pa jo sproži konstruktor shranjenega tipa E.

std::expected<T, E> hrani bodisi rezultat bodisi napako. Predaja std::unexpected<E> izbere stanje napake; v primeru bi return -1; pomenil uspešen rezultat tipa int, medtem ko return std::unexpected{-1}; pomeni neuspeh. Ta razlika velja tudi, kadar sta T in E enaka.

Do shranjene napake dostopate z std::unexpected<E>::error(). Pri std::expected<T, E> najprej preverite stanje: if (result) pomeni uspeh. *result uporabite samo ob uspehu, result.error() pa samo ob neuspehu. V C++23 klic value() na levi vrednosti (lvalue) zahteva, da je mogoče objekt tipa E konstruirati s kopiranjem. V stanju napake result.value() sproži izjemo std::bad_expected_access<E>, če je ta uspešno konstruirana. Kopiranje ali premikanje vrednosti napake tipa E med konstruiranjem te izjeme lahko namesto nje sproži drugo izjemo.

Primer zahteva podporo za C++23 tako v prevajalniku kot v standardni knjižnici. Prikazana koda je bila brez sprememb izvedena v izoliranem okolju, njen izpis pa je bil primerjan z navedenim rezultatom. Zastavica prevajalnika v repozitoriju ne potrjuje podpore za C++23 pri izvajanju v produkcijskem okolju. Priloženi izvorni dokument je osnutek, ki se še spreminja, in ne dokončna izdaja standarda C++23.

Primeri

#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';
        }
    }
}

Rezultat

value: 4
error: -1

Prikazana koda je bila brez sprememb izvedena v izoliranem okolju. Njen standardni izhod se je natančno ujemal z navedenim rezultatom.

Viri