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
Показаният код е изпълнен без промени в изолирана среда. Стандартният му изход съвпадна точно с посочения резултат.