Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::unexpected — indiquer explicitement un résultat en erreur

std::unexpected<E> de <expected> enveloppe une valeur d’erreur pour construire std::expected<T, E> dans son état d’échec. Il permet de distinguer une erreur d’un résultat réussi, même lorsque T et E sont du même type.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}

std::unexpected<E> est un modèle de classe disponible depuis C++23 dans <expected> qui stocke une valeur d’erreur. std::unexpected{error_value} déduit le type E. La création de l’enveloppe ne déclenche pas elle-même d’exception, mais le constructeur de E, le type stocké, peut en déclencher une.

std::expected<T, E> stocke soit un résultat, soit une erreur. Passer std::unexpected<E> sélectionne l’état d’erreur ; dans l’exemple, return -1; signifierait un résultat int valide, tandis que return std::unexpected{-1}; signifie un échec. Cette distinction fonctionne aussi lorsque T et E sont identiques.

std::unexpected<E>::error() permet d’accéder à l’erreur stockée. Pour std::expected<T, E>, vérifiez d’abord l’état : if (result) signifie que l’opération a réussi. Utilisez *result uniquement en cas de réussite et result.error() uniquement en cas d’échec. En C++23, appeler value() sur une lvalue exige que E soit constructible par copie. Dans l’état d’erreur, result.value() lève std::bad_expected_access<E> si cette exception est construite avec succès. La copie ou le déplacement de la valeur d’erreur de type E lors de cette construction peut lever une autre exception à la place.

L’exemple nécessite la prise en charge de C++23 par le compilateur et la bibliothèque standard. Le code affiché a été exécuté sans modification dans un environnement isolé et sa sortie a été comparée au résultat indiqué. L’option du compilateur utilisée dans le dépôt n’atteste pas la prise en charge à l’exécution dans l’environnement de production. Le document source fourni est un projet en cours d’évolution, et non une publication définitive de C++23.

Exemples

#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';
        }
    }
}

Résultat

value: 4
error: -1

Le code affiché a été exécuté sans modification dans un environnement isolé. Sa sortie standard correspondait exactement au résultat indiqué.

Sources