CKTIS / C++
std::expected: стойност или явна грешка
std::expected<T, E> съдържа точно едно от две състояния: очаквана стойност T или обект на грешка E, без празно състояние.
Версия: C++23
Синтаксис
template<class T, class E>
class expected {
public:
constexpr explicit operator bool() const noexcept;
constexpr T* operator->() noexcept;
constexpr T& operator*() & noexcept;
constexpr T& value() &;
constexpr E& error() & noexcept;
template<class U> constexpr T value_or(U&& fallback) const &;
};std::expected<T, E> от <expected> е дискриминиран съюз на C++23. Конструирайте успех от стойност T или std::in_place, а грешка чрез std::unexpected(error) или std::unexpect; has_value() и явното преобразуване към bool различават състоянията.
value() връща стойността, а в състояние на грешка хвърля std::bad_expected_access<E>, съдържащ грешката. error() не хвърля, но може да се извика само когато has_value() е false; operator* и operator-> също изискват състояние на стойност. Примерът безопасно извежда 7 при успех и missing при грешка.
std::expected::operator bool връща състоянието на успех както has_value(). std::expected::operator* и std::expected::operator-> дават непроверен достъп до стойността и изискват състояние на успех; нарушаването на това предусловие води до неопределено поведение. std::expected::error връща референция към грешката и обратно изисква състояние на грешка; за проверен достъп до стойността използвайте value(), което може да хвърли.
T трябва да е void или пълен обектен тип, който не е масив и спазва стандартните изключения; E трябва да е неквалифициран обектен тип, не масив или специализация на unexpected. Обектът никога не е без стойност, но копирането, преместването и монадичните операции имат собствени типови ограничения. value_or оценява резервния аргумент преди извикването като обикновен аргумент на функция.
Примери
#include <expected>
#include <iostream>
#include <string>
std::expected<int, std::string> fetch(bool found) {
if (found) return 7;
return std::unexpected(std::string{"missing"});
}
int main() {
const auto good = fetch(true);
const auto bad = fetch(false);
std::cout << good.value() << ' ' << bad.error() << '\n';
}
Резултат
7 missing
std::expected → 7 missing