База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::unexpected — изрично обозначаване на резултат с грешка

std::unexpected<E> от <expected> обвива стойност на грешка, за да създаде std::expected<T, E> в състояние на неуспех. Така грешката се различава от успешния резултат дори когато T и E са от един и същи тип.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}

std::unexpected<E> е шаблон на клас, наличен в <expected> от C++23, който съхранява стойност на грешка. std::unexpected{error_value} извежда типа E. Създаването на обвивката само по себе си не хвърля изключение, но конструкторът на съхранявания тип E може да го направи.

std::expected<T, E> съхранява или резултат, или грешка. Подаването на std::unexpected<E> избира състоянието на грешка; в примера return -1; би означавало успешен резултат от тип int, докато return std::unexpected{-1}; означава неуспех. Това разграничение важи и когато T и E са еднакви.

Достъп до съхранената грешка се получава чрез std::unexpected<E>::error(). При std::expected<T, E> първо проверете състоянието: if (result) означава успех. Използвайте *result само при успех, а result.error() — само при неуспех. В C++23 извикването на value() върху lvalue изисква обект от тип E да може да се конструира чрез копиране. В състояние на грешка result.value() хвърля std::bad_expected_access<E>, ако това изключение бъде успешно конструирано. При копиране или преместване на стойността на грешката от тип E по време на конструирането може вместо него да бъде хвърлено друго изключение.

Примерът изисква поддръжка на C++23 както от компилатора, така и от стандартната библиотека. Показаният код е изпълнен без промени в изолирана среда, а изходът му е сравнен с посочения резултат. Флагът на компилатора в хранилището не удостоверява поддръжка при изпълнение в производствената среда. Предоставеният документ е проект, който продължава да се обновява, а не окончателно издание на стандарта C++23.

Примери

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

Резултат

value: 4
error: -1

Показаният код е изпълнен без промени в изолирана среда. Стандартният му изход съвпадна точно с посочения резултат.

Източници