WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

longjmp — C23-Kontrollübertragungsfunktion

`longjmp(env, val)` aus `<setjmp.h>` stellt die vom letzten `setjmp(env)` gespeicherte Umgebung wieder her und kehrt nicht zur Aufrufstelle zurück. Das fortgesetzte `setjmp` liefert `val`, bei `val == 0` jedoch `1`, damit der Sprung vom ersten Durchlauf unterscheidbar bleibt.

Version: C23

Syntax

[[noreturn]] void longjmp(jmp_buf env, int val);

longjmp(env, val) aus <setjmp.h> stellt die vom letzten setjmp(env) gespeicherte Umgebung wieder her und kehrt nicht zur Aufrufstelle zurück. Das fortgesetzte setjmp liefert val, bei val == 0 jedoch 1, damit der Sprung vom ersten Durchlauf unterscheidbar bleibt.

Das Beispiel speichert einen jmp_buf auf Dateiebene; nach dem anfänglichen Nullergebnis ruft es eine Hilfsfunktion auf, die longjmp(environment, 42) ausführt. 42 beweist eine echte nichtlokale Übertragung statt eines normalen return.

Die Funktion mit setjmp muss noch aktiv sein und der Sprung im selben Thread bleiben, sonst ist das Verhalten undefiniert. Nach setjmp geänderte lokale automatische Objekte ohne volatile haben danach unbestimmte Werte. Ein Sprung in eine Umgebung aus einem verlassenen Bereich eines variabel modifizierten Objekts ist ebenfalls UB. longjmp gibt keine Ressourcen frei und umgeht normale Aufräumpfade.

Beispiele

#include <setjmp.h>
#include <stdio.h>
static jmp_buf environment;
static void finish(void){longjmp(environment,42);}
int main(void){int value=setjmp(environment);if(value==0)finish();printf("%d\n",value);return 0;}

Ergebnis

42

Das Beispiel speichert einen `jmp_buf` auf Dateiebene; nach dem anfänglichen Nullergebnis ruft es eine Hilfsfunktion auf, die `longjmp(environment, 42)` ausführt. `42` beweist eine echte nichtlokale Übertragung statt eines normalen `return`.

Quellen