Méthode « System.exit »

Signature

public static void exit( int status );

Description

Cette méthode permet d'arrêter votre programme en terminant l'exécution de la JVM (Java Virtual Machine). Tous les threads en cours d'exécution sont aussi terminés et l'espace de mémoire du processus est libéré.

Cette méthode accepte en paramètre un code numérique de sortie qui sera retourné au système d'exploitation (ou au processus) appelant. Conventionnellement, la valeur 0 correspond à une sortie en succès alors que les autres valeurs seront considérées comme un code d'erreur.

la méthode System.exit(value) appelle Runtime.getRuntime().exit(value) : les deux extraits de codes sont donc strictement équivalents.

Paramètre

Paramètre	Type	Description
status	int	Ce paramètre correspond au code de retour du processus. Ce code répond normalement aux conventions suivantes : Une valeur `0` indique que la JVM se termine en succès. Une valeur `-1` indique une erreur non déterminée. Toute autre valeur sera censée représenter une erreur particulière. La liste des codes d'erreurs est normalement documentée dans l'aide en ligne de votre programme.

Valeur de retour

Cette méthode ne renvoie aucune valeur.

Exception

Type de l'exception	Description
SecurityException	Peut-être déclenché si un gestionnaire de sécurité (`java.lang.SecurityManager`) existe et que sa méthode `checkExit` n'autorise pas la sortie avec le code spécifié.

Exemple de code

Voici un exemple d'utilisation de la méthode System.exit(int).

Exemple d'utilisation de la méthode System.exit(int)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21	public class Sample { public static void main( String[] args ) { for( int i=0; i<10; i++ ) { if ( i == 5 ) { // On sort définitivement du programme. System.exit( -1 ); } System.out.println( "Un nouveau tour de boucle avec : " + i ); } // Cette ligne ne sera jamais exécutée, car on stoppe le programme // avant la fin de la boucle. System.out.println( "Bye bye" ); } }

public class Sample {
    
    public static void main( String[] args ) {
        
        for( int i=0; i<10; i++ ) {
            
            if ( i == 5 ) {
                // On sort définitivement du programme.
                System.exit( -1 );
            }
            
            System.out.println( "Un nouveau tour de boucle avec : " + i );
        }

        // Cette ligne ne sera jamais exécutée, car on stoppe le programme
        // avant la fin de la boucle.
        System.out.println( "Bye bye" );
        
    }
    
}

Exemple d'utilisation de la méthode System.exit(int)

Et voici les résultats produits par cet exemple.

Un nouveau tour de boucle avec : 0
Un nouveau tour de boucle avec : 1
Un nouveau tour de boucle avec : 2
Un nouveau tour de boucle avec : 3
Un nouveau tour de boucle avec : 4