tc
Class TC

Object
  TC

public class TC
extends Object

Cette classe regroupe les fonctions pratiques de lecture et d'écriture pour le Tronc Commun.

Principe général :
Les fonctions de lecture utilisent une entrée. Par défaut, cette entrée est l'entrée standard, c'est-à-dire l'entrée de la console qui utilise normalement le clavier. Certaines fonctions de TC permettent de rediriger cette entrée pour qu'elle utilise, par exemple, le contenu d'un fichier à la place du clavier.
Les fonctions d'écriture utilisent une sortie. Par défaut, cette sortie est la sortie standard, c'est-à-dire normalement l'affichage dans la console. Certaines fonctions de TC permettent de rediriger cette sortie pour qu'elle se fasse, par exemple, dans un fichier. Dans ce cas, tout ce qu'on écrit en passant par les fonctions de sortie de TC, est enregistré dans le fichier.

Version:

mai 2013

Author:

Francois Morain, Julien Cervelle, Philippe Chassignet, École Polytechnique

lireChar

public static char lireChar()

Lecture du prochain caractère sur l'entrée. Tous les caractères, divers blancs compris, sont pris en compte à tour de rôle.
Remarque : finEntree() renvoie true lorsqu'il ne reste plus que des caractères blancs sur l'entrée.

Returns:

le caractère lu, comme une valeur de type char

Throws:

TCException - quand il n'y a plus de caractère sur l'entrée

lireMot

public static String lireMot()

Lecture d'un mot (une chaîne quelconque sans blanc) sur l'entrée.

Returns:

le mot lu sous la forme d'une chaîne Java (String)

Throws:

TCException - quand il n'y a plus de mot sur l'entrée

lireInt

public static int lireInt()

Lecture d'un int sur l'entrée.

Returns:

l'entier lu, comme une valeur de type int

Throws:

TCException - quand le mot lu n'est pas un entier représentable dans le type int ou quand il n'y a plus de mot sur l'entrée

lireLong

public static long lireLong()

Lecture d'un long sur l'entrée.

Returns:

l'entier lu, comme une valeur de type long

Throws:

TCException - quand le mot lu n'est pas un entier représentable dans le type long ou quand il n'y a plus de mot sur l'entrée

lireDouble

public static double lireDouble()

Lecture d'un double sur l'entrée.

Returns:

le nombre lu, comme une valeur de type double

Throws:

TCException - quand le mot lu n'est pas un flottant représentable dans le type double ou quand il n'y a plus de mot sur l'entrée

lireLigne

public static String lireLigne()

Lecture d'une ligne (tous les caractères, blancs compris, jusqu'au prochain retour à la ligne) sur l'entrée. Le retour à la ligne est lu, mais n'est pas dans la chaîne renvoyée.

Returns:

la ligne lue sous la forme d'une chaîne Java (String)

Throws:

TCException - quand il n'y a plus rien sur l'entrée

motsDeChaine

public static String[] motsDeChaine(String chaine)

Renvoie un tableau des mots obtenus en découpant le contenu d'une chaîne. Plusieurs espaces (ou autres caractères blancs) consécutifs sont considérés comme une seule séparation.

Parameters:

chaine - la chaîne à découper

Returns:

le tableau des mots obtenus

decoupage

public static String[] decoupage(String chaine,
                                 char separateur)

Renvoie un tableau de sous-chaînes obtenues en découpant le contenu d'une chaîne selon un caractère séparateur. Un séparateur au début ou à la fin ou plusieurs séparateurs consécutifs délimitent des sous-chaînes vides.

Parameters:

chaine - la chaîne à découper

separateur - le séparateur

Returns:

le tableau des sous-chaînes obtenues

finEntree

public static boolean finEntree()

Teste s'il ne reste plus de mot (plus de caractère non blanc) sur l'entrée.

Returns:

true s'il ne reste plus de mot (plus de caractère non blanc) sur l'entrée,
false s'il reste au moins un mot (au moins un caractère non blanc) sur l'entrée.

lectureDansFichier

public static void lectureDansFichier(String nomFichier)

Redirige l'entrée pour que la lecture utilise le contenu d'un fichier.

Parameters:

nomFichier - le nom du fichier

lectureEntreeStandard

public static void lectureEntreeStandard()

Redirige l'entrée pour que la lecture utilise l'entrée standard de la console (normalement le clavier). Cette fonction permet de revenir au mode initial après avoir utilisé une autre entrée.

lectureReader

public static void lectureReader(Reader input)

Redirige l'entrée pour que la lecture utilise un Reader, pour utilisateurs avertis.

Parameters:

input - l'objet Reader utilisé comme entrée

print

public static void print(boolean b)

Affiche un booléen sur la sortie.

Parameters:

b - le booléen à afficher

print

public static void print(char c)

Affiche un caractère sur la sortie.

Parameters:

c - le caractère à afficher

print

public static void print(long l)

Affiche un entier sur la sortie.

Parameters:

l - l'entier (type long) à afficher

print

public static void print(double d)

Affiche un flottant sur la sortie.

Parameters:

d - le flottant (type double) à afficher

print

public static void print(String chaine)

Affiche une chaîne sur la sortie.

Parameters:

chaine - la chaîne à afficher

print

public static void print(char[] t)

Affiche le contenu d'un tableau de char sur la sortie.

Parameters:

t - le tableau à afficher

print

public static void print(Object o)

Affiche un objet sur la sortie.
Cette fonction fait appel à la méthode o.toString() pour obtenir une représentation de l'objet.

Parameters:

o - une référence sur l'objet à afficher

println

public static void println()

Va à la ligne sur l'entrée.

println

public static void println(boolean b)

Affiche un booléen sur la sortie puis va à la ligne.

Parameters:

b - le booléen à afficher

println

public static void println(char c)

Affiche un caractère sur la sortie puis va à la ligne.

Parameters:

c - le caractère à afficher

println

public static void println(long l)

Affiche un entier sur la sortie puis va à la ligne.

Parameters:

l - l'entier (type long) à afficher

println

public static void println(double d)

Affiche un flottant sur la sortie puis va à la ligne.

Parameters:

d - le flottant (type double) à afficher

println

public static void println(String chaine)

Affiche une chaîne sur la sortie puis va à la ligne.

Parameters:

chaine - la chaîne à afficher

println

public static void println(char[] t)

Affiche le contenu d'un tableau de char sur la sortie puis va à la ligne.

Parameters:

t - le tableau à afficher

println

public static void println(Object o)

Affiche un objet sur la sortie puis va à la ligne.
Cette fonction fait appel à la méthode o.toString() pour obtenir une représentation de l'objet.

Parameters:

o - une référence sur l'objet à afficher

ecritureDansNouveauFichier

public static void ecritureDansNouveauFichier(String nomFichier)

Redirige la sortie des méthodes d'affichage pour écrire dans un nouveau fichier.
S'il existe déjà un fichier avec ce nom, le contenu de ce fichier est effacé pour commencer dans un fichier vide.

Parameters:

nomFichier - le nom du fichier

ecritureEnFinDeFichier

public static void ecritureEnFinDeFichier(String nomFichier)

Redirige la sortie des méthodes d'affichage pour écrire à la fin d'un fichier.
S'il n'existe pas de fichier avec ce nom, le fichier est créé pour commencer dans un fichier vide.
S'il existe déjà un fichier avec ce nom, la sortie des méthodes d'affichage est ajoutée à la fin du fichier.

Parameters:

nomFichier - le nom du fichier

ecritureSortieStandard

public static void ecritureSortieStandard()

Redirige la sortie des méthodes d'affichage vers la sortie standard, c'est-à-dire normalement l'affichage dans la console. Cette fonction permet de revenir au mode initial après avoir utilisé une autre sortie.

ecriturePrintStream

public static void ecriturePrintStream(PrintStream output)

Redirige la sortie des méthodes d'affichage vers un PrintStream, pour utilisateurs avertis.

Parameters:

output - l'objet PrintStream utilisé comme sortie