CKTIS / C++
std::runtime_error — wyjątek błędu wykonania
std::runtime_error z nagłówka <stdexcept> służy do zgłaszania błędów wykrywalnych podczas działania programu. Przechowuje komunikat dostępny przez what() i dziedziczy publicznie po std::exception.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 jest klasą wyjątków z nagłówka <stdexcept>, publicznie dziedziczącą po std::exception. Reprezentuje błędy, które przypuszczalnie można wykryć dopiero podczas wykonania, na przykład niedostępność usługi. W odróżnieniu od niej std::logic_error opisuje błędy wewnętrznej logiki programu, którym teoretycznie można zapobiec.
Konstruktory przyjmują komunikat what_arg jako const std::string& albo const char*. Funkcja what() zwraca wskaźnik do tekstu zakończonego znakiem zerowym. Po skonstruowaniu obiektu zachodzi odpowiednio strcmp(what(), what_arg.c_str()) == 0 albo strcmp(what(), what_arg) == 0. Jeśli przekazany std::string zawiera wewnętrzny znak zerowy ('\0'), nie ma gwarancji, że tekst zwrócony przez what() zachowa znaki występujące po nim. Funkcja what() nie zgłasza wyjątków. Zwrócony wskaźnik pozostaje ważny do zniszczenia obiektu wyjątku lub wywołania jego niestałej funkcji składowej; aby zachować tekst dłużej, skopiuj go do std::string.
Użyj throw, aby zgłosić wyjątek, i przechwytuj go przez const std::runtime_error&, aby uniknąć kopiowania. Samo utworzenie obiektu nie zgłasza go jako wyjątku. W przykładzie false deterministycznie symuluje niedostępność usługi, a blok catch wypisuje Service unavailable i znak nowej linii.
Wpis dotyczy C++23. Podany projekt standardu jest aktualizowany i pokazuje również deklaracje constexpr, których nie należy traktować jako gwarancji C++23. Flaga kompilatora w repozytorium nie potwierdza zachowania środowiska produkcyjnego; przykład wymaga lokalnej weryfikacji.
Przykłady
#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';
}
}
Wynik
Service unavailable
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.