Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

longjmp — funzione di trasferimento del controllo C23

`longjmp(env, val)` di `<setjmp.h>` ripristina l’ambiente salvato dall’ultimo `setjmp(env)` e non ritorna al punto di chiamata. Il `setjmp` ripreso restituisce `val`, oppure `1` se `val == 0`, per distinguere il salto dal primo passaggio.

Versione: C23

Sintassi

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

longjmp(env, val) di <setjmp.h> ripristina l’ambiente salvato dall’ultimo setjmp(env) e non ritorna al punto di chiamata. Il setjmp ripreso restituisce val, oppure 1 se val == 0, per distinguere il salto dal primo passaggio.

L’esempio conserva un jmp_buf a livello di file; dopo lo zero iniziale chiama un helper che esegue longjmp(environment, 42). L’output 42 dimostra un vero trasferimento non locale, non simulato con un normale return.

La funzione che eseguì setjmp deve essere ancora attiva e il salto restare nello stesso thread, altrimenti il comportamento è indefinito. I suoi oggetti automatici non volatile modificati dopo setjmp hanno valori indeterminati. Saltare a un ambiente salvato nell’ambito abbandonato di un oggetto a tipo variabilmente modificato è anch’esso UB. longjmp non libera risorse e salta la normale pulizia.

Esempi

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

Risultato

42

L’esempio conserva un `jmp_buf` a livello di file; dopo lo zero iniziale chiama un helper che esegue `longjmp(environment, 42)`. L’output `42` dimostra un vero trasferimento non locale, non simulato con un normale `return`.

Fonti