Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::unexpected — izričito označavanje rezultata s pogreškom

std::unexpected<E> iz <expected> obavija vrijednost pogreške kako bi se std::expected<T, E> konstruirao u stanju neuspjeha. Omogućuje razlikovanje pogreške od uspješnog rezultata čak i kada su T i E istog tipa.

Verzija: 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> predložak je klase dostupan od C++23 u <expected> koji pohranjuje vrijednost pogreške. std::unexpected{error_value} izvodi tip E. Stvaranje omotača samo po sebi ne izbacuje iznimku, no konstruktor pohranjenog tipa E može je izbaciti.

std::expected<T, E> pohranjuje ili rezultat ili pogrešku. Prosljeđivanje std::unexpected<E> odabire stanje pogreške; u primjeru bi return -1; značio uspješan rezultat tipa int, dok return std::unexpected{-1}; znači neuspjeh. Ta razlika vrijedi i kada su T i E jednaki.

Pohranjenoj pogrešci pristupa se pomoću std::unexpected<E>::error(). Za std::expected<T, E> najprije provjerite stanje: if (result) znači uspjeh. *result upotrebljavajte samo pri uspjehu, a result.error() samo pri neuspjehu. U C++23 poziv value() na l-vrijednosti (lvalue) zahtijeva da se objekt tipa E može konstruirati kopiranjem. U stanju pogreške result.value() izbacuje iznimku std::bad_expected_access<E> ako se ona uspješno konstruira. Kopiranje ili premještanje vrijednosti pogreške tipa E pri konstrukciji te iznimke može umjesto nje izbaciti drugu iznimku.

Primjer zahtijeva podršku za C++23 u kompilatoru i standardnoj biblioteci. Prikazani kôd izvršen je bez izmjena u izoliranom okruženju, a njegov je izlaz uspoređen s navedenim rezultatom. Opcija kompilatora u repozitoriju ne potvrđuje podršku pri izvršavanju u produkcijskom okruženju. Dostavljeni izvorni dokument nacrt je koji se još mijenja, a ne konačno izdanje standarda C++23.

Primjeri

#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

Prikazani kôd izvršen je bez izmjena u izoliranom okruženju. Njegov standardni izlaz točno se podudarao s navedenim rezultatom.

Izvori