CKTIS / C
setjmp — eine Aufrufumgebung speichern
`setjmp` speichert eine Umgebung in `jmp_buf`, sodass die Ausführung später über `longjmp` fortgesetzt werden kann.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <setjmp.h>
int setjmp(jmp_buf env);setjmp aus <setjmp.h> wird als Makro und nicht als gewöhnliche Funktion beschrieben. Beim ersten Aufruf gibt es 0 zurück; nach longjmp(env, value) gibt es value zurück, wobei 0 durch 1 ersetzt wird.
Ein Aufruf von setjmp darf den gesamten Steuerungsausdruck einer Auswahl- oder Schleifenanweisung bilden. Er darf auch als Operand des unären Operators ! oder als Operand eines Relations- oder Gleichheitsoperators auftreten, dessen anderer Operand ein ganzzahliger konstanter Ausdruck ist. In den beiden letzten Fällen muss der resultierende Ausdruck den gesamten Steuerungsausdruck einer Auswahl- oder Schleifenanweisung bilden. Der Aufruf darf auch den gesamten Ausdruck einer Ausdrucksanweisung bilden, optional mit einer Typumwandlung nach void. In jedem anderen Kontext ist das Verhalten undefiniert. Das gilt sowohl für int result = setjmp(env); als auch für die Verwendung als Steuerungsausdruck einer _Generic-Auswahl, obwohl dieser Ausdruck nicht ausgewertet wird.
Das Ziel muss im selben Thread aktiv bleiben. Geänderte automatische lokale Objekte ohne volatile in der Funktion, die die Umgebung speichert, erhalten einen unbestimmten Wert. Ein Sprung macht Ein-/Ausgabeoperationen nicht rückgängig.
Beispiele
#include <setjmp.h>
#include <stdio.h>
int main(void)
{
jmp_buf env;
if (setjmp(env) == 0) {
longjmp(env, 1);
} else {
puts("resumed");
}
return 0;
}
Ergebnis
resumed
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.