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

CKTIS / C++

std::current_exception — uchování zpracovávané výjimky

std::current_exception z hlavičky <exception> vrací std::exception_ptr odkazující na právě zpracovávanou výjimku nebo její kopii. Umožňuje výjimku uchovat a později ji znovu vyhodit; pokud se žádná výjimka nezpracovává, vrátí prázdnou hodnotu.

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

Syntaxe

#include <exception>
std::exception_ptr std::current_exception() noexcept;

std::current_exception() z <exception> zachytí právě zpracovávanou výjimku, obvykle uvnitř bloku catch. Vrací std::exception_ptr, který odkazuje na tuto výjimku nebo její kopii. Pokud se žádná výjimka nezpracovává, je výsledek prázdný: funkce neuchovává historii chyb.

Uchovaný objekt zůstává platný alespoň po dobu existence std::exception_ptr, který na něj odkazuje, a to i po skončení bloku catch. Chcete-li výjimku vyhodit později znovu, použijte std::rethrow_exception(saved). Nejprve ověřte if (saved): tato funkce vyžaduje neprázdný argument.

noexcept znamená, že samotné zachycení nevyhodí výjimku volajícímu. Neúspěšná alokace však může uchovat std::bad_alloc; při neúspěšném kopírování se může uchovat výjimka vyhozená při kopírování nebo std::bad_exception. Nepředpokládejte také, že výsledky dvou po sobě jdoucích volání odkazují na stejný objekt.

Příklad před zpracováním výjimek ověří, zda je výsledek prázdný, poté uchová 42 a znovu ji vyhodí po opuštění bloku catch. Kód je určen pro C++23; dodané zdroje jsou průběžně aktualizovaný pracovní návrh, nikoli neměnné vydání C++23.

Příklady

#include <exception>
#include <iostream>

int main() {
    std::cout << std::boolalpha << !std::current_exception() << '\n';

    std::exception_ptr saved;
    try {
        throw 42;
    } catch (...) {
        saved = std::current_exception();
    }

    if (saved) {
        try {
            std::rethrow_exception(saved);
        } catch (int value) {
            std::cout << value << '\n';
        } catch (...) {
            std::cout << "capture or rethrow failed\n";
        }
    }
}

Výsledek

true
42

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