CKTIS / C
<setjmp.h> — salti non locali
L’header <setjmp.h> salva un punto di ritorno e riprende l’esecuzione da quel punto a partire da una chiamata annidata. Richiede un controllo rigoroso delle durate di vita e delle risorse.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);<setjmp.h> fornisce il tipo array jmp_buf, la macro setjmp e la funzione longjmp. In C23, __STDC_VERSION_SETJMP_H__ vale 202311L. La dichiarazione di setjmp nella sintassi è descrittiva: non dichiararla autonomamente e non disattivare la macro.
setjmp(env) salva l’ambiente di chiamata e inizialmente restituisce 0. longjmp(env, val) riprende l’esecuzione da quel punto con il risultato val, sostituendo 0 con 1; non ritorna mai al chiamante.
La sola chiamata a setjmp, la sua negazione logica (!) o un confronto relazionale o di uguaglianza in cui un operando è la chiamata e l’altro è un’espressione costante intera deve costituire l’intera espressione di controllo di un’istruzione di selezione o di iterazione. In alternativa, la chiamata, eventualmente convertita esplicitamente in void, può costituire l’intera espressione di un’istruzione espressione. Non usare setjmp come condizione dell’operatore ?:. L’inizializzazione int r = setjmp(env); causa un comportamento indefinito.
La destinazione deve essere ancora attiva nello stesso thread; non saltare mai in una funzione terminata o in un ambito già abbandonato di un tipo modificato variabilmente. Gli oggetti locali automatici della funzione di destinazione che non sono volatile e che sono cambiati dopo il salvataggio dell’ambiente hanno una rappresentazione indeterminata. Il salto omette il codice di pulizia, non libera risorse e non ripristina lo stato dei file o dell’ambiente in virgola mobile.
Esempi
#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;
}
Risultato
before recovered
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.