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

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

Източници