longjmp

void longjmp( jmp_buf env, int status );

_Noreturn void longjmp( jmp_buf env, int status );

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

Charge le contexte d'exécution env sauvegardé par un appel précédent à setjmp. Cette fonction ne retourne pas. Le contrôle est transféré au site d'appel de la macro setjmp qui a configuré env. Ce setjmp retourne alors la valeur passée comme status.

Si la fonction qui a appelé setjmp s'est terminée (que ce soit par un retour ou par un autre longjmp plus haut dans la pile), le comportement est indéfini. En d'autres termes, seuls les sauts longs vers le haut de la pile d'appel sont autorisés.

void g(int n)
{
    int a[n]; // a may remain allocated
    h(n); // does not return
}
void h(int n)
{
    int b[n]; // b may remain allocated
    longjmp(buf, 2); // might cause a memory leak for h's b and g's a
}

Paramètres

Notes

longjmp est destiné à la gestion des conditions d'erreur imprévues où la fonction ne peut pas retourner de manière significative. Cela est similaire à la gestion des exceptions dans d'autres langages de programmation.

Exemple

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

jmp_buf my_jump_buffer;

noreturn void foo(int status)
{
    printf("foo(%d) called\n", status);
    longjmp(my_jump_buffer, status + 1); // will return status+1 out of setjmp
}

int main(void)
{
    volatile int count = 0; // modified local vars in setjmp scope must be volatile
    if (setjmp(my_jump_buffer) != 5) // compare against constant in an if
        foo(++count);
}

foo(1) called
foo(2) called
foo(3) called
foo(4) called

Références

Voir aussi