Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti