WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::current_exception — die behandelte Ausnahme aufbewahren

std::current_exception aus <exception> gibt einen std::exception_ptr zurück, der auf die aktuell behandelte Ausnahme oder eine Kopie davon verweist. So lässt sich eine Ausnahme aufbewahren und später erneut auslösen; wird gerade keine Ausnahme behandelt, ist der Rückgabewert leer.

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

Syntax

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

std::current_exception() aus <exception> erfasst die aktuell behandelte Ausnahme, üblicherweise innerhalb eines catch-Blocks. Die Funktion gibt einen std::exception_ptr zurück, der auf diese Ausnahme oder eine Kopie davon verweist. Wird gerade keine Ausnahme behandelt, ist das Ergebnis leer: Die Funktion speichert keinen Fehlerverlauf.

Das aufbewahrte Objekt bleibt mindestens so lange gültig, wie ein darauf verweisender std::exception_ptr existiert, auch nachdem der catch-Block beendet ist. Um die Ausnahme später auszulösen, verwende std::rethrow_exception(saved). Prüfe zuerst if (saved): Die Funktion darf kein leeres Argument erhalten.

noexcept bedeutet, dass das Erfassen selbst keine Ausnahme an den Aufrufer weitergibt. Bei einem fehlgeschlagenen Speichervorgang kann jedoch std::bad_alloc aufbewahrt werden; bei einem fehlgeschlagenen Kopiervorgang die beim Kopieren ausgelöste Ausnahme oder std::bad_exception. Gehe außerdem nicht davon aus, dass zwei aufeinanderfolgende Aufrufe auf dasselbe Objekt verweisen.

Das Beispiel prüft vor der Ausnahmebehandlung, ob das Ergebnis leer ist. Danach bewahrt es 42 auf und löst die Ausnahme nach dem Verlassen des catch-Blocks erneut aus. Der Code zielt auf C++23; die bereitgestellten Quellen sind ein fortlaufend aktualisierter Arbeitsentwurf und keine unveränderliche C++23-Veröffentlichung.

Beispiele

#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";
        }
    }
}

Ergebnis

true
42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen