longjmp, siglongjmp − Saut non-local vers un contexte de pile sauvegardé.

#include <setjmp.h>

void longjmp (jmp_buf env, int val);
void siglongjmp (sigjmp_buf env, int val);

longjmp() et setjmp() sont utiles pour la gestion d’erreurs et d’interruptions rencontrées dans une routine bas-niveau d’un programme. longjmp() restitue l’environnement sauvegardé lors du dernier appel de setjmp() avec l’argument env correspondant. Après l’appel de longjmp() l’exécution du programme continue comme si l’appel correspondant de setjmp() venait juste de renvoyer val. longjmp() ne peut pas renvoyer 0. Si longjmp est appelé avec 0 en tant que second argument, setjmp renverra 1 à la place.

siglongjmp() est identique à longjmp() hormis le type de son argument env. Si l’argument savesigs est non nul lors de l’appel de sigsetjmp(), alors siglongjmp() restituera également l’ensemble des signaux bloqués.

Ces fonctions ne reviennent jamais.

POSIX

longjmp() et siglongjmp() rendent les programmes difficiles à comprendre et à maintenir. Il est préférable si possible utiliser une autre méthode.

setjmp(3), sigsetjmp(3).

Christophe Blaess, 1997.