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.1-2001.

POSIX ne précise pas si longjmp() restore le contexte de signal. Si vous voulez sauver et restorer le masque de signaux, utilisez siglongjmp().

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

setjmp(3), sigsetjmp(3)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 4 novembre 1996 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 longjmp ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.