Fonction exit

Entête à inclure

#include <stdlib.h>  // <cstdlib> en C++

Fonction exit

void exit( int returnCode );

La fonction exit permet de mettre fin au programme en spécifiant un code de retour. Ce code de retour, passé en paramètre de la fonction exit, permet de spécifier comment le programme se termine. Une valeur nulle (0 ou constanteEXIT_SUCCESS) indique au système d'exploitation que l'exécution de ce programme s'est bien déroulée. Tout autre valeur indique une sortie anormale du programme (la constante EXIT_FAILURE peut aussi être utilisée).

Si des fonctions ont été enregistrées pour exécution en fin de programme, via la fonction atexit, l'appel à exit provoquera l'exécution de ces fonctions.

Paramètres

• returnCode : permet d'indiquer la valeur du code de retour du programme. Ce code de retour est renvoyé au système d'exploitation qui peut alors permettre un réaction en conséquence. Deux valeur sont prédéfinies : EXIT_SUCCESS et EXIT_FAILURE.

Valeur de retour

Cette fonction ne renvoit pas de valeur étant donné que le programme est stoppé.

Exemple de code

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

int main( int argc, char *argv[] ) {
    if ( argc != 3 ) {
        printf( "Usage : copy fileSource fileDest\n" );
        exit( EXIT_SUCCESS );    /* La copie ne sera pas réalisée */
    }

    /* traitement à effectuer : copie du fichier */
    /* . . . */
    
    return EXIT_SUCCESS;
}

Attention : selon les points de vues, on peut considérer que l'affichage de l'usage d'une commande (comme dans l'exemple proposé) est un cas de fonctionnement normal de l'application. On peut aussi considérer que c'est un cas d'erreur : dans ce cas préférez plutôt utiliser la constante EXIT_FAILURE.

Sujets connexes