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

CKTIS / C++

std::terminate — ukončení bez návratu

std::terminate z hlavičky <exception> zavolá obslužnou funkci ukončení programu a nikdy se nevrátí. Vyvolá ji například nezachycená výjimka nebo výjimka, která opustí funkci noexcept; lze ji také zavolat přímo. Nezaručuje úklid prostředků pomocí destruktorů.

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

Syntaxe

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

std::terminate() z <exception> nepřijímá žádné argumenty a nikdy se nevrátí. Volá obslužnou funkci typu std::terminate_handler; výchozí obslužná funkce volá std::abort(). Nejde o vyhození výjimky ani o mechanismus obnovy, který by mohl zachytit catch.

Mezi běžné příčiny patří chybějící odpovídající catch, výjimka opouštějící funkci noexcept, destruktor, který během odvíjení zásobníku skončí vyhozením výjimky, a zničení objektu std::thread, který je stále joinable(). Program může také zavolat std::terminate() přímo.

Nepředpokládejte úplný úklid pomocí RAII. Pokud neexistuje odpovídající obsluha výjimky, odvíjení zásobníku závisí na implementaci; když výjimka opustí funkci noexcept, může být odvíjení úplné, částečné nebo žádné. Přímé zavolání std::terminate() samo zásobník neodvíjí.

Pomocí std::set_terminate lze nainstalovat vlastní obslužnou funkci. Ta musí ukončit program, aniž by se vrátila volajícímu. Příklad instaluje stop, která volá std::_Exit(EXIT_FAILURE): žádný textový výstup, stav ukončení signalizující neúspěch a žádné spuštění destruktorů ani funkcí zaregistrovaných pomocí std::atexit. Spusťte jej jako samostatný proces.

Tento záznam se vztahuje k C++23. Uvedené stránky jsou průběžně se vyvíjejícím návrhem standardu a obsahují také pozdější doplňky; tento záznam tyto doplňky nepřisuzuje C++23. Příznak kompilátoru v repozitáři nepotvrzuje produkční běhové prostředí.

Příklady

#include <cstdlib>
#include <exception>

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

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

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