Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::runtime_error — výnimka pre chybu počas behu

std::runtime_error z hlavičky <stdexcept> oznamuje chyby zistiteľné počas behu programu. Uchováva správu dostupnú cez what() a verejne dedí z std::exception.

Verzia: 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 je trieda výnimky z <stdexcept>, ktorá verejne dedí z std::exception. Predstavuje chyby, ktoré možno pravdepodobne zistiť až počas behu programu, napríklad nedostupnosť služby. Naopak, std::logic_error opisuje chyby vo vnútornej logike programu, ktorým sa teoreticky dá predísť.

Jej konštruktory prijímajú správu what_arg typu const std::string& alebo const char*. Funkcia what() vracia ukazovateľ na text ukončený nulovým znakom. Po vytvorení objektu platí pre prvé preťaženie strcmp(what(), what_arg.c_str()) == 0 a pre druhé strcmp(what(), what_arg) == 0. Ak odovzdaný std::string obsahuje vložený nulový znak ('\0'), nie je zaručené, že what() zachová znaky, ktoré za ním nasledujú. Funkcia what() nevyvoláva výnimky. Vrátený ukazovateľ zostáva platný až do zničenia objektu výnimky alebo zavolania niektorej z jeho nekonštantných členských funkcií. Ak potrebujete text uchovať dlhšie, skopírujte ho do std::string.

Výnimku vyvolajte pomocou throw a zachyťte ju cez const std::runtime_error&, aby ste sa vyhli kopírovaniu. Samotné vytvorenie objektu ho nevyvolá ako výnimku. V príklade false deterministicky simuluje nedostupnú službu a blok catch vypíše Service unavailable nasledované znakom nového riadka.

Tento záznam sa týka C++23. Dodaný pracovný návrh sa vyvíja a uvádza aj deklarácie constexpr, ktoré sa nesmú považovať za záruky C++23. Príznak kompilátora v repozitári nedokazuje správanie počas behu v produkcii; príklad si vyžaduje lokálne overenie.

Príklady

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

Výsledok

Service unavailable

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje