CKTIS / C++
std::unexpected — expliciet een foutresultaat aangeven
std::unexpected<E> uit <expected> verpakt een foutwaarde om std::expected<T, E> in de fouttoestand te construeren. Hiermee is een fout te onderscheiden van een geslaagd resultaat, zelfs als T en E hetzelfde type zijn.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}std::unexpected<E> is een klassentemplate die sinds C++23 beschikbaar is in <expected> en een foutwaarde opslaat. std::unexpected{error_value} leidt het type E af. Het maken van de wrapper veroorzaakt zelf geen uitzondering, maar de constructor van de opgeslagen E kan dat wel doen.
std::expected<T, E> slaat een resultaat of een fout op. Het doorgeven van std::unexpected<E> selecteert de fouttoestand; in het voorbeeld zou return -1; een geslaagd resultaat van het type int betekenen, terwijl return std::unexpected{-1}; een fout betekent. Dit onderscheid werkt ook als T en E identiek zijn.
Met std::unexpected<E>::error() krijg je toegang tot de opgeslagen fout. Controleer bij std::expected<T, E> eerst de toestand: if (result) betekent succes. Gebruik *result alleen bij succes en result.error() alleen bij een fout. In C++23 vereist een aanroep van value() op een lvalue dat E door kopiëren kan worden geconstrueerd. In de fouttoestand werpt result.value() de uitzondering std::bad_expected_access<E> op als die met succes wordt geconstrueerd. Bij het kopiëren of verplaatsen van de foutwaarde van het type E tijdens die constructie kan in plaats daarvan een andere uitzondering optreden.
Het voorbeeld vereist ondersteuning voor C++23 in zowel de compiler als de standaardbibliotheek. De getoonde code is ongewijzigd uitgevoerd in een geïsoleerde omgeving en de uitvoer is vergeleken met het opgegeven resultaat. De compileroptie in de repository toont niet aan dat C++23 ook bij uitvoering in de productieomgeving wordt ondersteund. Het meegeleverde brondocument is een doorlopend bijgewerkt concept, geen definitieve C++23-publicatie.
Voorbeelden
#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';
}
}
}
Resultaat
value: 4 error: -1
De getoonde code is ongewijzigd uitgevoerd in een geïsoleerde omgeving. De standaarduitvoer kwam exact overeen met het opgegeven resultaat.