Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

setjmp — salvare un ambiente di chiamata

`setjmp` salva un ambiente in `jmp_buf`, consentendo di riprendere in seguito l’esecuzione tramite `longjmp`.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <setjmp.h>
int setjmp(jmp_buf env);

setjmp di <setjmp.h> è descritto come una macro, non come una normale funzione. Inizialmente restituisce 0; dopo longjmp(env, value), restituisce value, sostituendo 0 con 1.

Un’invocazione di setjmp può costituire l’intera espressione di controllo di un’istruzione di selezione o di iterazione. Può anche essere l’operando dell’operatore unario ! o uno degli operandi di un operatore relazionale o di uguaglianza il cui altro operando sia un’espressione costante intera. In questi ultimi due casi, l’espressione risultante deve costituire l’intera espressione di controllo di un’istruzione di selezione o di iterazione. L’invocazione può anche costituire l’intera espressione di un’istruzione espressione, con o senza conversione esplicita a void. Qualsiasi altro contesto causa un comportamento indefinito. Ciò vale per int result = setjmp(env); e per l’uso dell’invocazione come espressione di controllo di una selezione generica _Generic, anche se tale espressione non viene valutata.

La destinazione deve rimanere attiva nello stesso thread. Gli oggetti automatici locali modificati e privi di volatile nella funzione che salva l’ambiente diventano indeterminati. Un salto non annulla le operazioni di input/output.

Esempi

#include <setjmp.h>
#include <stdio.h>

int main(void)
{
    jmp_buf env;
    if (setjmp(env) == 0) {
        longjmp(env, 1);
    } else {
        puts("resumed");
    }
    return 0;
}

Risultato

resumed

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