Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::terminate — zakończenie programu bez powrotu

std::terminate z nagłówka <exception> wywołuje procedurę kończącą program i nigdy nie wraca. Jest uruchamiane m.in. przy nieobsłużonym wyjątku lub wyjątku opuszczającym funkcję noexcept; można je też wywołać jawnie. Nie gwarantuje sprzątania zasobów przez destruktory.

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

Składnia

#include <exception>
[[noreturn]] void std::terminate() noexcept;

std::terminate() z nagłówka <exception> nie przyjmuje argumentów i nigdy nie wraca. Wywołuje procedurę typu std::terminate_handler; domyślna procedura wywołuje std::abort(). To nie jest rzucenie wyjątku ani mechanizm odzyskiwania działania przez catch.

Typowe przyczyny to brak pasującego catch, wyjątek opuszczający funkcję noexcept, destruktor kończący się wyjątkiem podczas odwijania stosu oraz zniszczenie obiektu std::thread, który nadal jest joinable(). Program może też jawnie wywołać std::terminate().

Nie zakładaj pełnego sprzątania przez RAII. Przy braku pasującej obsługi wyjątku odwijanie stosu zależy od implementacji; przy opuszczeniu funkcji noexcept może być pełne, częściowe albo nie nastąpić. Samo jawne wywołanie std::terminate() nie odwija stosu.

std::set_terminate pozwala ustawić własną procedurę. Musi ona zakończyć program bez powrotu do wywołującego. Przykład instaluje stop, które wywołuje std::_Exit(EXIT_FAILURE): brak wyjścia tekstowego, status zakończenia oznaczający niepowodzenie, bez uruchamiania destruktorów ani funkcji zarejestrowanych przez std::atexit. Uruchamiaj go jako osobny proces.

Zakres wpisu to C++23. Podane strony są rozwijanym szkicem standardu i zawierają także późniejsze dodatki; wpis nie przenosi ich do C++23. Flaga kompilatora w repozytorium nie potwierdza środowiska wykonawczego produkcji.

Przykłady

#include <cstdlib>
#include <exception>

[[noreturn]] void stop() noexcept {
    std::_Exit(EXIT_FAILURE);
}

int main() {
    std::set_terminate(stop);
    std::terminate();
}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła