NOM

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

SYNOPSIS

       #include <setjmp.h>

       void longjmp(jmp_buf env, int val);

       void siglongjmp(sigjmp_buf env, int val);

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consultez
   feature_test_macros(7)) :

       siglongjmp() : _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_C_SOURCE

DESCRIPTION

       longjmp()  et  setjmp(3)  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(3) avec  l'argument  env  correspondant.  Après
       l'appel  longjmp(),  l'exécution  du  programme continue comme si l'appel correspondant de
       setjmp(3) venait juste de renvoyer val. longjmp() ne peut pas renvoyer 0. Si  longjmp  est
       appelé avec 0 en tant que second argument, setjmp(3) renverra 1 à la place.

       siglongjmp()  est  identique  à  longjmp() excepté pour le type de son argument env. Si et
       seulement si l'appel sigsetjmp(3) définit cet env, utilisé comme drapeau savesigs non nul,
       alors siglongjmp() restituera également le signal masqué qui a été sauvé par sigsetjmp(3).

VALEUR RENVOYÉE

       Ces fonctions ne reviennent jamais.

CONFORMITÉ

       C89, C99 et POSIX.1-2001 spécifient longjmp(). POSIX.1-2001 spécifie siglongjmp().

NOTES

       POSIX  ne  précise  pas si longjmp() restaurera le contexte du signal (consultez setjmp(3)
       pour plus de détails). Si vous voulez sauver et restaurer le masque de  signaux  de  façon
       portable, utilisez sigsetjmp(3) et siglongjmp().

       Les  valeurs  des variables automatiques ne sont pas spécifiées après un appel à longjmp()
       si elles suivent tous les critères suivants :

       •  elles sont locales à la fonction qui effectue l'appel correspondant setjmp(3) ;

       •  leur valeur est changée entre les appels setjmp(3) et longjmp() ;

       •  elles ne sont pas déclarées comme volatile.

       Ces remarques s'appliquent aussi à siglongjmp().

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

VOIR AUSSI

       setjmp(3), sigsetjmp(3)

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/> (2003-2006). Florentin  Duneau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».

                                         13 janvier 2009                               LONGJMP(3)