CKTIS / C++
std::unexpected — jawne oznaczanie wyniku błędu
std::unexpected<E> z nagłówka <expected> opakowuje wartość błędu, aby skonstruować std::expected<T, E> w stanie niepowodzenia. Pozwala odróżnić błąd od poprawnego wyniku nawet wtedy, gdy T i E są tym samym typem.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}std::unexpected<E> to dostępna od C++23 klasa szablonowa z <expected>, przechowująca wartość błędu. std::unexpected{error_value} dedukuje typ E. Samo utworzenie opakowania nie zgłasza wyjątku, ale konstruktor przechowywanego E może go zgłosić.
std::expected<T, E> przechowuje wynik albo błąd. Przekazanie std::unexpected<E> wybiera stan błędu; w przykładzie return -1; oznaczałoby poprawny wynik typu int, natomiast return std::unexpected{-1}; oznacza niepowodzenie. To rozróżnienie działa również wtedy, gdy T i E są identyczne.
std::unexpected<E>::error() udostępnia przechowywany błąd. Dla std::expected<T, E> najpierw sprawdź stan: if (result) oznacza sukces. Używaj *result tylko przy sukcesie, a result.error() tylko przy niepowodzeniu. W C++23 wywołanie value() na l-wartości wymaga, aby E można było skonstruować przez kopiowanie. W stanie błędu result.value() zgłasza std::bad_expected_access<E>, jeśli uda się skonstruować ten wyjątek. Kopiowanie lub przenoszenie wartości błędu typu E podczas jego konstruowania może jednak zgłosić inny wyjątek.
Przykład wymaga obsługi C++23 w kompilatorze i bibliotece standardowej. Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku i potwierdzono, że wyjście było zgodne z podanym wynikiem. Flaga kompilatora w repozytorium nie potwierdza obsługi w środowisku produkcyjnym. Podany źródłowy dokument jest rozwijanym szkicem, a nie zamrożoną publikacją C++23.
Przykłady
#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';
}
}
}
Wynik
value: 4 error: -1
Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku. Standardowe wyjście było dokładnie zgodne z podanym wynikiem.