Le minimum à savoir : une entrée et une sortie standard

B.5.1 Le minimum à savoir : une entrée et une sortie standard

Nous connaissons déjà la sortie standard, c’est System.out — et System.err est la sortie d’erreur. Nous savons déjà écrire dans ces flux de classe PrintStream, par leurs méthodes print et println. Pour lire l’entrée standard (System.in, comme vous pouviez vous en douter), c’est un rien plus complexe, mais sans plus.

Il faut tout d’abord fabriquer un flux de caractères, objet de la classe, Reader (voir aussi B.6.2.1) à partir de System.in :

Reader in = new InputStreamReader(System.in) ;

On note que l’objet InputStreamReader est rangé dans une variable de type Reader. Et en effet, InputStreamReader est une sous-classe de Reader (voir B.2.3).

Ensuite, on peut lire le prochain caractère de l’entrée par l’appel in.read(). Cette méthode renvoie un int, avec le comportement un peu tordu suivant :

Si un caractère est lu, il est renvoyé comme un entier.
Si on est à la fin de l’entrée, -1 est renvoyé. La fin de l’entrée est par vous signalée par « Control-d » au clavier et est la fin de fichier si il y a eu redirection.
En cas d’erreur l’exception IOException est lancée. Ces erreurs sont du genre de celles détectées au niveau du système d’exploitation, comme la panne d’un disque (rare !), ou un délai abusif de transmission par le réseau (plus fréquent). Bref, l’exception est lancée quand, pour une raison ou une autre, la lecture est jugée impossible.

Voici Cat (source Cat.java) un filtre trivial qui copie l’entrée standard dans la sortie standard :

import java.io.*; // La classe Reader est dans le package java.io

class Cat {
  public static void main(String [] arg) {
    try {
      Reader in =  new InputStreamReader(System.in) ;
      for ( ; ; ) {// Boucle infinie, on sort par break
        int c = in.read ();
        if (c == -1) break;
        System.out.print ((char)c);
      }
    } catch (IOException e) { // En cas de malaise
      System.err.print("Malaise : " + e.getMessage()) ;
      System.exit(2) ; // Terminer le programme sur erreur
    }
  }
}

Remarquons :

Il y a un try… catch (voir B.4.1), car la méthode read déclare lancer l’exception IOException, qui doit être attrapée dans main si elle n’est pas déclarée dans la signature de main. À la fin du traitement de l’exception, on utilise la méthode System.exit qui arrête le programme d’un coup. Le message d’erreur est écrit dans la sortie d’erreur.
Pour afficher c comme un caractère, il faut le changer en caractère, par (char)c. Sinon, c’est un code de caractère qui s’affiche.

On peut tester le programme Cat par exemple ainsi :

% java Cat < Cat.java
import java.io.*; // La classe Reader est dans le package java.io
  ⋮