CKTIS / C
<setjmp.h> — nichtlokale Sprünge
Der Header <setjmp.h> speichert einen Rückkehrpunkt und setzt die Ausführung von einem verschachtelten Aufruf aus dort fort. Dafür müssen Lebensdauern und Ressourcen streng kontrolliert werden.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);<setjmp.h> stellt den Arraytyp jmp_buf, das Makro setjmp und die Funktion longjmp bereit. In C23 hat __STDC_VERSION_SETJMP_H__ den Wert 202311L. Die setjmp-Deklaration in der Syntax ist beschreibend: Deklariere sie nicht selbst und unterdrücke das Makro nicht.
setjmp(env) speichert die Aufrufumgebung und gibt zunächst 0 zurück. longjmp(env, val) setzt die Ausführung an diesem Punkt mit dem Ergebnis val fort und ersetzt dabei 0 durch 1; die Funktion kehrt nicht zu ihrem Aufrufer zurück.
Der unveränderte Aufruf von setjmp, seine logische Negation (!) oder ein relationaler Vergleich oder Gleichheitsvergleich, bei dem der Aufruf ein Operand und der andere ein ganzzahliger konstanter Ausdruck ist, muss den gesamten Steuerausdruck einer Auswahl- oder Schleifenanweisung bilden. Alternativ darf der Aufruf, gegebenenfalls nach einer expliziten Umwandlung in void, den gesamten Ausdruck einer Ausdrucksanweisung bilden. Verwende setjmp nicht als Bedingung des Operators ?:. Die Initialisierung int r = setjmp(env); verursacht undefiniertes Verhalten.
Das Ziel muss im selben Thread weiterhin gültig sein; springe niemals in eine beendete Funktion oder in den verlassenen Gültigkeitsbereich eines variabel modifizierten Typs. Automatische lokale Objekte der Zielfunktion ohne volatile, die sich seit dem Speichern der Umgebung geändert haben, haben eine unbestimmte Repräsentation. Der Sprung überspringt Bereinigungscode, gibt keine Ressourcen frei und stellt weder den Zustand von Dateien noch die Gleitkommaumgebung wieder her.
Beispiele
#include <setjmp.h>
#include <stdio.h>
static jmp_buf env;
static void fail(void)
{
longjmp(env, 0);
}
int main(void)
{
if (setjmp(env) == 0) {
puts("before");
fail();
puts("unreachable");
} else {
puts("recovered");
}
return 0;
}
Ergebnis
before recovered
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.