TextInputOutput

All Known Implementing Classes:

Program
```
public interface TextInputOutput
```
Fonctions de gestion des entrées / sorties en mode texte
Les fonctions print/println et readXXX permettent l'affichage et la saisie d'informations par la console d'exécution du programme. Cette console, aussi appelée terminal, est la fenêtre qui s'ouvre dès le démarrage du programme et qui permet la gestion des entrées-sorties de type 'caractère' (aussi appelé mode texte).
Fonctions print et println pour l'affichage / les sorties
Typage
Le type de l'information affichée est déduit du type de l'expression fournie. Ainsi la suite d'instructions:
```
  int i = 65 ;
 char c = 'B' ;
 print(i) ;
 print(c) ;
 print((char) i) ; 
```
provoquerons l'affichage successif de 65, B et A (la valeur numérique de A est 65). Si l'on doit afficher un assemblage de valeur de type différent (comme "I = 12, I+1 = 13"), il est possible d'utiliser une combinaison de concaténations et d'un appel à print(String) comme dans exemple suivant (attention au parenthésage):
```
 print("I = " + i + ", I+1 = "+(I+1)) ;
```
Saut de ligne
Les sauts de lignes s'obtiennent de deux façons:
- Par appel à println. Dans ce cas un seul saut de ligne est effectué après la valeur affichée.
- Par insertion explicite du caractère de fin de ligne (appelé 'line feed' et représenté par le caractère '\n'. Ce caractère peut être inclus une fois ou plusieurs fois dans une chaîne de caractère. Chaque apparition provoquera le passage à la ligne suivante.
  Le code print("*\n**\n*") ; aura donc pour résultat:
```
  *
 **
 *
 
```
Fonctions readXxx() pour les saisies / les entrées
L'appel à une fonction de type readXxx provoquera la suspension de l'exécution du programme, ce qui donne la possibilité à l'utilisateur de saisir une valeur au clavier (les caractères saisis sont affichés au fur et à mesure).
Lors de cette saisie l'utilisateur dispose des facilités habituelles (retour arrière, copier/coller, ...). Quand la saisie est validée par l'utilisateur (appui sur la touche de fin de ligne), le programme tente d'interpréter les caractères saisis comme une valeur du type demandé (Xxx).
- Si la saisie est correcte, la valeur retournée représente ce qui a été saisi par l'utilisateur.
- Dans les autres cas (format de saisie non reconnu ou dépassement de valeur limite), une erreur de type InputMismatchException se produit comme dans l'exemple suivant:
```
  java.util.InputMismatchException
 at java.util.Scanner.throwFor(Scanner.java:909)
 at java.util.Scanner.next(Scanner.java:1530)
 at java.util.Scanner.nextInt(Scanner.java:2160)
 at java.util.Scanner.nextInt(Scanner.java:2119)
 at Program.readInt(Program.java:1061)

 at TestProgram.algorithm(TestProgram.java:4)

 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
 at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
 at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
 at  reflect.Method.invoke(Method.java:606)
 at Program.main(Program.java:1225)
 [iJava] Exception while running algorithm in TestProgram
 
```
  Pour cette exemple, la ligne incriminé est la ligne 4 de TestProgram.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`print(boolean b)` Affiche une valeur booléenne.
`void`	`print(char c)` Affiche un caractère ou d'une expression de même type.
`void`	`print(double d)` Affiche la valeur d'un réel (double précision) ou d'une expression de même type.
`void`	`print(float f)` Affiche la valeur d'un réel (simple précision) ou d'une expression de même type.
`void`	`print(int i)` Affiche la valeur d'un entier ou d'une expression de même type.
`void`	`print(long l)` Affiche la valeur d'un entier long ou d'une expression de même type.
`void`	`print( String s)` Affiche une chaîne de caractères ou une expression donnant une chaîne de caractères.
`void`	`println()` Force un saut de ligne sur le terminal.
`void`	`println(boolean b)` Affiche une valeur booléenne, puis passe à la ligne.
`void`	`println(char c)` Affiche un caractère ou d'une expression de même type, puis passe à la ligne.
`void`	`println(double d)` Affiche la valeur d'un réel (double précision) ou d'une expression de même type, puis passe à la ligne.
`void`	`println(float f)` Affiche la valeur d'un réel (simple précision) ou d'une expression de même type, puis passe à la ligne.
`void`	`println(int i)` Affiche la valeur d'un entier ou d'une expression de même type, puis passe à la ligne.
`void`	`println(long l)` Affiche la valeur d'un entier long ou d'une expression de même type, puis passe à la ligne.
`void`	`println( String s)` Affiche une chaîne de caractères ou une expression donnant une chaîne puis passe à la ligne.
`char`	`readChar()` Demande la saisie d'un caractère.
`char`	`readChar(long timeout)` Demande la saisie en un temps limité d'un caractère.
`double`	`readDouble()` Demande la saisie d'une valeur réelle (double précision).
`double`	`readDouble(long timeout)` Demande la saisie en un temps limité d'une valeur réelle (double précision).
`float`	`readFloat()` Demande la saisie d'une valeur réelle (simple précision).
`float`	`readFloat(long timeout)` Demande la saisie en un temps limité d'une valeur réelle (simple précision).
`int`	`readInt()` Demande la saisie d'une valeur entière.
`int`	`readInt(long timeout)` Demande la saisie en un temps limité d'une valeur entière.
`long`	`readLong()` Demande la saisie d'une valeur entière 'long'.
`long`	`readLong(long timeout)` Demande la saisie en un temps limité d'une valeur entière 'long'.
`String`	`readString()` Demande la saisie d'une chaîne de caractères.
`String`	`readString(long timeout)` Demande la saisie en un temps limité d'une chaîne de caractères.

- Method Detail
  - print
```
void print( String s)
```
    Affiche une chaîne de caractères ou une expression donnant une chaîne de caractères. Voir typage et saut de ligne.
    
    Parameters:
    
    s - La chaîne à afficher.
  - print
```
void print(int i)
```
    Affiche la valeur d'un entier ou d'une expression de même type. Voir typage et saut de ligne.
    
    Parameters:
    
    i - La valeur entière à afficher.
  - print
```
void print(long l)
```
    Affiche la valeur d'un entier long ou d'une expression de même type. Voir typage et saut de ligne.
    
    Parameters:
    
    l - La valeur de type 'long' à afficher.
  - print
```
void print(float f)
```
    Affiche la valeur d'un réel (simple précision) ou d'une expression de même type. Voir typage et saut de ligne.
    
    Parameters:
    
    f - la valeur réelle à afficher.
  - print
```
void print(double d)
```
    Affiche la valeur d'un réel (double précision) ou d'une expression de même type. Voir typage et Saut de ligne.
    
    Parameters:
    
    d - la valeur réelle (double précision) à afficher.
  - print
```
void print(char c)
```
    Affiche un caractère ou d'une expression de même type. Voir typage et Saut de ligne.
    
    Parameters:
    
    c - le caractère à afficher.
  - print
```
void print(boolean b)
```
    Affiche une valeur booléenne. Voir typage et Saut de ligne.
    
    Parameters:
    
    b - l'expression booléenne à afficher.
  - println
```
void println()
```
    Force un saut de ligne sur le terminal.
  - println
```
void println( String s)
```
    Affiche une chaîne de caractères ou une expression donnant une chaîne puis passe à la ligne.
    
    Parameters:
    
    s - La chaîne à afficher.
  - println
```
void println(int i)
```
    Affiche la valeur d'un entier ou d'une expression de même type, puis passe à la ligne.
    
    Parameters:
    
    i - La valeur de type entier à afficher.
  - println
```
void println(long l)
```
    Affiche la valeur d'un entier long ou d'une expression de même type, puis passe à la ligne.
    
    Parameters:
    
    l - La valeur de type entier long à afficher.
  - println
```
void println(float f)
```
    Affiche la valeur d'un réel (simple précision) ou d'une expression de même type, puis passe à la ligne.
    
    Parameters:
    
    f - la valeur réelle à afficher.
  - println
```
void println(double d)
```
    Affiche la valeur d'un réel (double précision) ou d'une expression de même type, puis passe à la ligne.
    
    Parameters:
    
    d - la valeur réelle (double précision) à afficher.
  - println
```
void println(char c)
```
    Affiche un caractère ou d'une expression de même type, puis passe à la ligne.
    
    Parameters:
    
    c - le caractère à afficher.
  - println
```
void println(boolean b)
```
    Affiche une valeur booléenne, puis passe à la ligne.
    
    Parameters:
    
    b - l'expression booléenne à afficher.
  - readInt
```
int readInt()
```
    Demande la saisie d'une valeur entière. L'entier saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle int i = readInt().
    La saisie s'effectue impérativement en décimal. {
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readLong
```
long readLong()
```
    Demande la saisie d'une valeur entière 'long'. L'entier saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle i = readLong().
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readFloat
```
float readFloat()
```
    Demande la saisie d'une valeur réelle (simple précision). Le réel saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle float i = readFloat(). le format de saisie supporte une mantisse signée et éventuellement un point décimal et un exposant (entier signé). Quelques exemples de valeurs saisies: 3.14, -2.71, -3.5E-06.
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readDouble
```
double readDouble()
```
    Demande la saisie d'une valeur réelle (double précision). Le réel saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle double i = readDouble(). le format de saisie supporte une mantisse signée et éventuellement un point décimal et un exposant (entier signé). Quelques exemples de valeurs saisies: 3.14, -2.71, -3.5E-06.
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readString
```
 String readString()
```
    Demande la saisie d'une chaîne de caractères. La chaîne saisie est délimitée d'une part par la position courante sur le terminal et d'autre part par la fin de ligne. Le caractère de fin de ligne proprement dit n'est pas inclut dans la chaîne saisie mais est ignoré pour les saisies ultérieures. Autrement-dit, le programme se place au début de la ligne suivante.
    
    Returns:
    
    La chaîne saisie au clavier après validation par la touche Entrée.
  - readChar
```
char readChar()
```
    Demande la saisie d'un caractère. Le caractère saisi est le premier caractère tapé les caractères suivant de la même ligne sont ignorés.
    
    Returns:
    
    Le caractère saisi au clavier après validation par la touche Entrée.
  - readInt
```
int readInt(long timeout)
```
    Demande la saisie en un temps limité d'une valeur entière. L'entier saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle int i = readInt(5000).
    La saisie s'effectue impérativement en décimal. {
    
    Parameters:
    
    timeout - Le nombre de millisecondes dont dispose l'utilisateur pour effectuer sa saisie
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readLong
```
long readLong(long timeout)
```
    Demande la saisie en un temps limité d'une valeur entière 'long'. L'entier saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle i = readLong().
    
    Parameters:
    
    timeout - Le nombre de millisecondes dont dispose l'utilisateur pour effectuer sa saisie
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readFloat
```
float readFloat(long timeout)
```
    Demande la saisie en un temps limité d'une valeur réelle (simple précision). Le réel saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle float i = readFloat(). Le format de saisie supporte une mantisse signée et éventuellement un point décimal et un exposant (entier signé). Quelques exemples de valeurs saisies: 3.14, -2.71, -3.5E-06.
    
    Parameters:
    
    timeout - Le nombre de millisecondes dont dispose l'utilisateur pour effectuer sa saisie
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readDouble
```
double readDouble(long timeout)
```
    Demande la saisie en un temps limité d'une valeur réelle (double précision). Le réel saisi forme la valeur de retour de la fonction qui généralement est appelée à droite d'une affectation selon la syntaxe traditionnelle double i = readDouble(). le format de saisie supporte une mantisse signée et éventuellement un point décimal et un exposant (entier signé). Quelques exemples de valeurs saisies: 3.14, -2.71, -3.5E-06.
    
    Parameters:
    
    timeout - Le nombre de millisecondes dont dispose l'utilisateur pour effectuer sa saisie
    
    Returns:
    
    La valeur saisie au clavier après validation par la touche Entrée.
  - readString
```
 String readString(long timeout)
```
    Demande la saisie en un temps limité d'une chaîne de caractères. La chaîne saisie est délimitée d'une part par la position courante sur le terminal et d'autre part par la fin de ligne. Le caractère de fin de ligne proprement dit n'est pas inclut dans la chaîne saisie mais est ignoré pour les saisies ultérieures. Autrement-dit, le programme se place au début de la ligne suivante.
    
    Parameters:
    
    timeout - Le nombre de millisecondes dont dispose l'utilisateur pour effectuer sa saisie
    
    Returns:
    
    La chaîne saisie au clavier après validation par la touche Entrée.
  - readChar
```
char readChar(long timeout)
```
    Demande la saisie en un temps limité d'un caractère. Le caractère saisi est le premier caractère tapé si l'utilisateur a saisit d'autres caractères sur la même ligne, ils sont ignorés.
    
    Parameters:
    
    timeout - Le nombre de millisecondes dont dispose l'utilisateur pour effectuer sa saisie
    
    Returns:
    
    Le caractère saisi au clavier après validation par la touche Entrée.

Interface TextInputOutput

Fonctions de gestion des entrées / sorties en mode texte

Fonctions `print` et `println` pour l'affichage / les sorties

Fonctions `readXxx()` pour les saisies / les entrées

Method Summary

Method Detail

print

print

print

print

print

print

print

println

println

println

println

println

println

println

println

readInt

readLong

readFloat

readDouble

readString

readChar

readInt

readLong

readFloat

readDouble

readString

readChar

Interface TextInputOutput

Fonctions de gestion des entrées / sorties en mode texte

Fonctions print et println pour l'affichage / les sorties

Fonctions readXxx() pour les saisies / les entrées

Method Summary

Method Detail

print

print

print

print

print

print

print

println

println

println

println

println

println

println

println

readInt

readLong

readFloat

readDouble

readString

readChar

readInt

readLong

readFloat

readDouble

readString

readChar

Fonctions `print` et `println` pour l'affichage / les sorties

Fonctions `readXxx()` pour les saisies / les entrées