Vous êtes un professionnel et vous avez besoin d'une formation ? Programmation avec
Le langage C Voir le programme détaillé

La librairie <setjmp.h> (<csetjmp> en C++)

Le type jmp_buf

Accès rapide :
Présentation de l'entête <setjmp.h>
Exemple d'utilisation
Eléments C ISO
Extensions POSIX

Présentation de l'entête <setjmp.h>

La librairie <setjmp.h> propose un mécanisme de saut non local. Elle permet de sauvegarder un point d'exécution avec setjmp, puis d'y revenir plus tard avec longjmp, même si plusieurs appels de fonctions ont été franchis entre-temps.

Cette possibilité peut être utile pour sortir rapidement d'une séquence d'appels imbriqués, par exemple en cas d'erreur difficile à traiter localement. Il faut toutefois l'utiliser avec prudence : un saut non local ne ferme pas automatiquement les fichiers, ne libère pas les blocs mémoire alloués et ne remplace pas une gestion d'erreur structurée.

Pour utiliser les éléments proposés par cette librairie, il suffit d'inclure l'entête suivant.

#include <setjmp.h>

Exemple d'utilisation

L'exemple suivant sauvegarde un point de reprise dans main. Une fonction plus profonde détecte ensuite une erreur et revient directement à ce point avec longjmp.

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 

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

static jmp_buf recoveryPoint;

static void loadModule( int id ) {

    if ( id == 2 ) {
        longjmp( recoveryPoint, id );
    }

    printf( "Module %d chargé.\n", id );
}

int main() {

    int errorCode = setjmp( recoveryPoint );

    if ( errorCode == 0 ) {
        loadModule( 1 );
        loadModule( 2 );
        puts( "Fin normale." );
    } else {
        printf( "Erreur détectée dans le module %d.\n", errorCode );
    }

    return EXIT_SUCCESS;
}

Cet exemple produit le résultat suivant.

Module 1 chargé.
Erreur détectée dans le module 2.

Eléments C ISO

Extensions POSIX

POSIX complète cet entête avec des variantes capables de sauvegarder et de restaurer le masque des signaux bloqués. Ces éléments sont utiles quand un saut non local est déclenché depuis une logique liée aux signaux.

Le type jmp_buf

Vous êtes un professionnel et vous avez besoin d'une formation ? Programmation avec
Le langage C Voir le programme détaillé