CKTIS / C++
std::runtime_error — uitzondering voor runtimefouten
std::runtime_error uit <stdexcept> meldt fouten die tijdens de uitvoering van een programma detecteerbaar zijn. De klasse bevat een bericht dat via what() toegankelijk is en erft publiekelijk van std::exception.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#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 is een exceptionklasse uit <stdexcept> die publiekelijk erft van std::exception. De klasse staat voor fouten die vermoedelijk pas tijdens de uitvoering kunnen worden ontdekt, zoals een niet-beschikbare dienst. std::logic_error beschrijft daarentegen fouten in de interne programmalogica die theoretisch te voorkomen zijn.
De constructors nemen een bericht what_arg aan als const std::string& of const char*. De functie what() geeft een pointer naar tekst terug die eindigt op een nul-teken. Na constructie geldt voor de eerste overload strcmp(what(), what_arg.c_str()) == 0 en voor de tweede strcmp(what(), what_arg) == 0. Als de opgegeven std::string een ingebed nul-teken ('\0') bevat, is niet gegarandeerd dat what() de tekens daarna behoudt. De functie what() werpt geen exceptions. De teruggegeven pointer blijft geldig totdat het exceptionobject wordt vernietigd of een van zijn niet-const memberfuncties wordt aangeroepen. Kopieer de tekst naar een std::string als die langer behouden moet blijven.
Gebruik throw om de exception te werpen en vang deze op via const std::runtime_error& om kopiëren te vermijden. Alleen het object aanmaken werpt het niet als exception. In het voorbeeld simuleert false op deterministische wijze een niet-beschikbare dienst, en het catch-blok schrijft Service unavailable gevolgd door een regelafbreking.
Deze vermelding is bedoeld voor C++23. Het aangeleverde werkdocument wordt bijgewerkt en toont ook constexpr-declaraties die niet als garanties van C++23 mogen worden beschouwd. Een compileroptie in de repository toont niet aan hoe het programma zich in productie tijdens runtime gedraagt; het voorbeeld moet lokaal worden geverifieerd.
Voorbeelden
#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';
}
}
Resultaat
Service unavailable
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.