Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<setjmp.h> — sauts non locaux

L’en-tête <setjmp.h> enregistre un point de retour et permet de reprendre l’exécution à cet endroit depuis un appel imbriqué. Son utilisation exige un contrôle strict des durées de vie et des ressources.

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

Syntaxe

#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);

<setjmp.h> fournit le type tableau jmp_buf, la macro setjmp et la fonction longjmp. En C23, __STDC_VERSION_SETJMP_H__ vaut 202311L. La déclaration de setjmp présentée dans la syntaxe est descriptive : ne la déclarez pas vous-même et ne désactivez pas sa macro.

setjmp(env) enregistre l’environnement d’appel et renvoie initialement 0. longjmp(env, val) reprend l’exécution à ce point avec le résultat val, en remplaçant 0 par 1 ; cette fonction ne revient jamais à son appelant.

L’appel seul à setjmp, sa négation logique (!) ou une comparaison au moyen d’un opérateur relationnel ou d’égalité dont l’un des opérandes est l’appel et l’autre une expression constante entière doit constituer à lui seul l’expression de contrôle d’une instruction de sélection ou d’itération. L’appel, éventuellement converti explicitement en void, peut aussi constituer toute l’expression d’une instruction-expression. N’utilisez pas setjmp comme condition de l’opérateur ?:. L’initialisation int r = setjmp(env); entraîne un comportement indéfini.

La cible doit toujours être active dans le même thread ; ne sautez jamais vers une fonction terminée ni vers la portée quittée d’un type modifié de façon variable. Les objets locaux automatiques non volatile de la fonction cible qui ont été modifiés depuis l’enregistrement de l’environnement ont une représentation indéterminée. Le saut ignore le code de nettoyage, ne libère pas les ressources et ne restaure ni l’état des fichiers ni celui de l’environnement en virgule flottante.

Exemples

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

Résultat

before
recovered

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources