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

CKTIS / C++

std::runtime_error — exception d’erreur d’exécution

std::runtime_error, déclarée dans <stdexcept>, signale les erreurs détectables pendant l’exécution du programme. Elle contient un message accessible avec what() et dérive publiquement de std::exception.

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

Syntaxe

#include <stdexcept>

// C++23
explicit runtime_error(const std::string& what_arg);
explicit runtime_error(const char* what_arg);

throw std::runtime_error("Service unavailable");

std::runtime_error est une classe d’exception de <stdexcept> qui dérive publiquement de std::exception. Elle représente les erreurs que l’on ne peut probablement détecter qu’à l’exécution, par exemple l’indisponibilité d’un service. À l’inverse, std::logic_error décrit des erreurs dans la logique interne du programme, que l’on peut théoriquement éviter.

Ses constructeurs acceptent un message what_arg de type const std::string& ou const char*. La fonction what() renvoie un pointeur vers un texte terminé par un caractère nul. Après construction, on a strcmp(what(), what_arg.c_str()) == 0 pour la première surcharge et strcmp(what(), what_arg) == 0 pour la seconde. Si le std::string fourni contient un caractère nul interne ('\0'), rien ne garantit que what() conserve les caractères qui le suivent. La fonction what() ne lance pas d’exception. Le pointeur renvoyé reste valide jusqu’à la destruction de l’objet exception ou jusqu’à l’appel de l’une de ses fonctions membres non constantes. Pour conserver le texte plus longtemps, copiez-le dans un std::string.

Utilisez throw pour lancer l’exception et interceptez-la avec const std::runtime_error& afin d’éviter une copie. La simple construction de l’objet ne le lance pas comme exception. Dans l’exemple, false simule de façon déterministe l’indisponibilité d’un service, et le bloc catch affiche Service unavailable suivi d’un saut de ligne.

Cette entrée concerne C++23. Le projet de norme fourni évolue et présente aussi des déclarations constexpr qui ne doivent pas être considérées comme des garanties de C++23. Une option de compilation du dépôt ne prouve pas le comportement à l’exécution en production ; l’exemple doit être vérifié localement.

Exemples

#include <iostream>
#include <stdexcept>

void access_service(bool available) {
    if (!available) {
        throw std::runtime_error("Service unavailable");
    }
}

int main() {
    try {
        access_service(false);
    } catch (const std::runtime_error& error) {
        std::cout << error.what() << '\n';
    }
}

Résultat

Service unavailable

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources