std:: expected

Die Klassenvorlage std::expected bietet eine Möglichkeit, einen von zwei Werten darzustellen: einen erwarteten Wert vom Typ T oder einen unerwarteten Wert vom Typ E . expected ist niemals wertlos.

Ein Programm ist fehlerhaft, wenn es ein expected mit einem Referenztyp, einem Funktionstyp oder einer Spezialisierung von std::unexpected instanziiert. Zusätzlich darf T nicht std::in_place_t oder std::unexpect_t sein.

Template-Parameter

Verschachtelte Typen

Member-Templates

Datenmitglieder

Memberfunktionen

Nicht-Member-Funktionen

Hilfsklassen

Hinweise

Typen mit der gleichen Funktionalität werden Result in Rust und Either in Haskell genannt.

Beispiel

#include <cmath>
#include <expected>
#include <iomanip>
#include <iostream>
#include <string_view>
enum class parse_error
{
    invalid_input,
    overflow
};
auto parse_number(std::string_view& str) -> std::expected<double, parse_error>
{
    const char* begin = str.data();
    char* end;
    double retval = std::strtod(begin, &end);
    if (begin == end)
        return std::unexpected(parse_error::invalid_input);
    else if (std::isinf(retval))
        return std::unexpected(parse_error::overflow);
    str.remove_prefix(end - begin);
    return retval;
}
int main()
{
    auto process = [](std::string_view str)
    {
        std::cout << "str: " << std::quoted(str) << ", ";
        if (const auto num = parse_number(str); num.has_value())
            std::cout << "value: " << *num << '\n';
            // Wenn num keinen Wert hätte, würde das Dereferenzieren von num
            // zu undefiniertem Verhalten führen, und
            // num.value() würde std::bad_expected_access werfen.
            // num.value_or(123) verwendet den angegebenen Standardwert 123.
        else if (num.error() == parse_error::invalid_input)
            std::cout << "error: invalid input\n";
        else if (num.error() == parse_error::overflow)
            std::cout << "error: overflow\n";
        else
            std::cout << "unexpected!\n"; // oder std::unreachable() aufrufen;
    };
    for (auto src : {"42", "42abc", "meow", "inf"})
        process(src);
}

str: "42", value: 42
str: "42abc", value: 42
str: "meow", error: invalid input
str: "inf", error: overflow

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Referenzen

Siehe auch