Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::runtime_error — výjimka pro chybu za běhu

std::runtime_error z hlavičky <stdexcept> oznamuje chyby zjistitelné během běhu programu. Uchovává zprávu dostupnou přes what() a veřejně dědí z std::exception.

Verze: 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 je třída výjimky z <stdexcept>, která veřejně dědí z std::exception. Představuje chyby, které lze pravděpodobně zjistit až za běhu programu, například nedostupnost služby. Naproti tomu std::logic_error popisuje chyby ve vnitřní logice programu, kterým lze teoreticky předejít.

Její konstruktory přijímají zprávu what_arg typu const std::string& nebo const char*. Funkce what() vrací ukazatel na text zakončený nulovým znakem. Po vytvoření objektu platí pro první přetížení strcmp(what(), what_arg.c_str()) == 0 a pro druhé strcmp(what(), what_arg) == 0. Pokud předaný std::string obsahuje vložený nulový znak ('\0'), není zaručeno, že what() zachová znaky, které po něm následují. Funkce what() nevyvolává výjimky. Vrácený ukazatel zůstává platný až do zničení objektu výjimky nebo zavolání některé z jeho nekonstantních členských funkcí. Pokud potřebujete text uchovat déle, zkopírujte jej do std::string.

Výjimku vyvoláte pomocí throw a zachytíte ji přes const std::runtime_error&, abyste se vyhnuli kopírování. Pouhé vytvoření objektu jej nevyvolá jako výjimku. V příkladu false deterministicky simuluje nedostupnou službu a blok catch vypíše Service unavailable následované znakem nového řádku.

Tento záznam se vztahuje k C++23. Dodaný pracovní návrh se vyvíjí a uvádí také deklarace constexpr, které se nesmějí považovat za záruky C++23. Příznak kompilátoru v repozitáři nedokládá chování za běhu v produkci; příklad je třeba ověřit místně.

Pří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ýsledek

Service unavailable

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje