Deug

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

fr.jussieu.script
Class Deug

java.lang.Object
  fr.jussieu.script.Deug

public final class Deug
extends java.lang.Object
extends java.lang.Object

La classe Deug permet de réaliser:

des entrées/sorties,
des dessins,
quelques manipulations élémentaires de chaînes de caractères.

Elle permet de masquer certaines constructions de Java que nous avons considérées comme trop avancées pour une initiation à la programmation. D'autre part, une tentative d'uniformisation de nommage a été faite afin de normaliser les incantations Java.

Entrées/Sorties

Les entrées ne prennent leur source qu'au clavier et les sorties ne se réalisent qu'à l'écran du terminal.

Les fonctions print(type) et println(type) permettant d'afficher tout type de données (la seconde série produit en plus un retour à la ligne).

Les entrées se font par l'intermédiaire des fonctions readType() pour tout type de données primitives Java. Chaqcune de ces fonctions positionne en cas d'erreur un état que l'on peut interroger par les fonctions isOk() et getStatus().

Dessins

Un exemple de programme graphique typique est le suivant:

 Deug.startDrawings(200,200);
 for (i=0; i<200; i+=4) {
   Deug.setGray(i);
   Deug.drawLine(0,i,199,199-i);
   Deug.drawLine(i,0,199-i,199);
 }
 Deug.stopDrawings();

Pour obtenir:

Chaînes

On trouvera les fonctions typeToString() et stringTotype() où (type peut être: boolean, int, long, ou double) qui réalisent les conversions attendues.

On trouvera aussi les fonctions de comparaison: equals(), compare(), subString(), charAt() et length().

Version:: 0.19, 30/10/08
Author:: Jean-Baptiste.Yunes@liafa.jussieu.fr, Fabien.Tarissan@pps.jussieu.fr

Field Summary
`static int`	`ARG_ERROR` L'argument passé est invalide (ex: `==null`)
`static int`	`FORMAT_ERROR` La conversion de type sur la chaîne de caractère lue sur l'entrée n'a pas été possible.
`static int`	`NO_ERROR` Rien à signaler en ce qui concerne la dernière opération d'entrée/sortie.
`static int`	`STREAM_ERROR` La lecture sur le flot d'entrée s'est révélée impossible. comme trop avancées pour une initiation à la programmation.

Method Summary
`static java.lang.String`	`booleanToString(boolean value)` Convertit un booléen en chaîne de caractères.
`static char`	`charAt(java.lang.String aString, int position)`
`static java.lang.String`	`charToString(char value)` Convertit un caractère en une de chaîne de caractères.
`static void`	`clearArea()` Efface intégralement le contenu de la fenêtre graphique.
`static int`	`compare(java.lang.String aString, java.lang.String anotherString)` Compare deux chaînes de caractères.
`static java.lang.String`	`doubleToString(double value)` Convertit un réel double en de chaîne de caractères.
`static void`	`drawArc(int x, int y, int r, int angleInit, int angleCouvert)` Dessine un arc de cercle vide dans la zone d'affichage.
`static void`	`drawCircle(int x, int y, int r)` Dessine un cercle vide dans la zone d'affichage.
`static void`	`drawLine(int x0, int y0, int x1, int y1)` Dessine un segment de droite dans la zone d'affichage.
`static void`	`drawPoint(int x, int y)` Dessine un point dans la zone d'affichage.
`static void`	`drawRect(int x, int y, int l, int h)` Dessine un rectangle vide dans la zone d'affichage.
`static boolean`	`equals(java.lang.String aString, java.lang.String anotherString)` Compare deux chaînes de caractères.
`static void`	`exit()` Termine toute exécution de la machine.
`static void`	`fillArc(int x, int y, int r, int angleInit, int angleCouvert)` Dessine un arc de cercle plein dans la zone d'affichage.
`static void`	`fillCircle(int x, int y, int r)` Dessine un cercle plein dans la zone d'affichage.
`static void`	`fillRect(int x, int y, int l, int h)` Dessine un rectangle plein dans la zone d'affichage.
`static java.lang.String`	`floatToString(float value)` Convertit un réel simple en chaîne de caractères.
`static int`	`getStatus()` Renvoie l'erreur rencontrée lors de la dernière opération d'entrée/sortie.
`static java.lang.String`	`intToString(int value)` Convertit un entier en chaîne de caractères.
`static boolean`	`isOk()` Renvoie l'état de la dernière opération d'entrée/sortie.
`static int`	`length(java.lang.String aString)` Calcule la longueur d'une chaîne de caractères.
`static java.lang.String`	`longToString(long value)` Convertit un entier long en chaîne de caractères.
`static void`	`print(boolean b)` Affiche la valeur d'un booléen (`boolean`)
`static void`	`print(char c)` Affiche un caractère Unicode.
`static void`	`print(double d)` Affiche la valeur d'un flottant double précision (`double`)
`static void`	`print(float f)` Affiche la valeur d'un flottant simple précision (`float`)
`static void`	`print(int i)` Affiche la valeur d'un entier (`int`)
`static void`	`print(long l)` Affiche la valeur d'un entier long (`long`)
`static void`	`print(java.lang.Object o)` Affiche la représentation en `String` de l'objet
`static void`	`print(java.lang.String s)` Affiche la chaîne de caractère (`String`)
`static void`	`println()` Affiche un saut de ligne.
`static void`	`println(boolean b)` Affiche la valeur d'un booléen (`boolean`) suivie d'un saut de ligne.
`static void`	`println(char c)` Affiche un caractère suivi d'un saut de ligne.
`static void`	`println(double d)` Affiche un flottant double précision suivi d'une fin de ligne.
`static void`	`println(float f)` Affiche la valeur d'un flottant simple précision (`float`) suivie d'un saut de ligne.
`static void`	`println(int i)` Affiche la valeur d'un entier (`int`) suivie d'un saut de ligne.
`static void`	`println(long l)` Affiche la valeur d'un entier long (`long`) suivie d'un saut de ligne.
`static void`	`println(java.lang.Object o)`
`static void`	`println(java.lang.String s)`
`static char`	`readChar()` Lit sur l'entrée un caractère et renvoie sa valeur.
`static double`	`readDouble()` Lit un lexème sur l'entrée et le convertit en `double`.
`static float`	`readFloat()` Lit un lexème sur l'entrée et le convertit en `float`.
`static int`	`readInt()` Lit un lexème sur l'entrée et le convertit en `int`.
`static java.lang.String`	`readLine()` Lit l'ensemble des caractères jusqu'à la prochaine fin de ligne.
`static long`	`readLong()` Lit un lexème sur l'entrée et le convertit en `long`.
`static java.lang.String`	`readString()` Lit un mot sur l'entrée.
`static void`	`setGray(int c)` Modifie la couleur de l'encre des points à dessiner.
`static void`	`startDrawings()` Prépare une zone d'affichage de taille 200x200.
`static void`	`startDrawings(int width, int height)` Prépare une zone d'affichage de taille arbitraire.
`static void`	`stopDrawings()` Ferme la fenêtre graphique.
`static boolean`	`stringToBoolean(java.lang.String s)` Convertit une chaîne de caractères en `boolean`.
`static byte`	`stringToByte(java.lang.String s)` Convertit une chaîne de caractères en `byte`.
`static double`	`stringToDouble(java.lang.String s)` Convertit une chaîne de caractères en `double`.
`static float`	`stringToFloat(java.lang.String s)` Convertit une chaîne de caractères en `float`.
`static int`	`stringToInt(java.lang.String s)` Convertit une chaîne de caractères en `int`.
`static long`	`stringToLong(java.lang.String s)` Convertit une chaîne de caractères en `long`.
`static java.lang.String`	`subString(java.lang.String aString, int begin, int end)` Extrait une sous-chaîne d'une chaîne donnée.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

NO_ERROR

public static final int NO_ERROR

Rien à signaler en ce qui concerne la dernière opération d'entrée/sortie.

See Also:: Constant Field Values

STREAM_ERROR

public static final int STREAM_ERROR

La lecture sur le flot d'entrée s'est révélée impossible. comme trop avancées pour une initiation à la programmation. D'autre part, une tentative d'uniformisation de nommage a été faite afin de normaliser les incantations Java.

See Also:: Constant Field Values

FORMAT_ERROR

public static final int FORMAT_ERROR

La conversion de type sur la chaîne de caractère lue sur l'entrée n'a pas été possible.

See Also:: Constant Field Values

ARG_ERROR

public static final int ARG_ERROR

L'argument passé est invalide (ex: ==null)

See Also:: Constant Field Values

Method Detail

isOk

public static boolean isOk()

Renvoie l'état de la dernière opération d'entrée/sortie.

true: si tout s'est bien passé;
false: si une erreur s'est produite. En ce cas, il peut être utile de consulter la cause de l'erreur (getStatus()).

Un appel est équivalent à getStatus()==NO_ERROR.

Returns:: l'état logique de la dernière opération.

getStatus

public static int getStatus()

Renvoie l'erreur rencontrée lors de la dernière opération d'entrée/sortie.

Returns:: la dernière erreur recontrée.

readChar

public static char readChar()

Lit sur l'entrée un caractère et renvoie sa valeur.

Les octets lus l'ont été sur l'entrée standard.

Returns:: le caractère lu sur l'entrée. Si le caractère renvoyé est le caractère <nul> il est alors nécessaire de consulter l'état de l'opération (isOk()).

exit

public static void exit()

Termine toute exécution de la machine.

readLine

public static java.lang.String readLine()

Lit l'ensemble des caractères jusqu'à la prochaine fin de ligne.

Les caractères lus le sont par l'intermédiaire de la méthode readChar()

Returns:: la ligne suivante disponible sur l'entrée.

stringToBoolean

public static boolean stringToBoolean(java.lang.String s)

Convertit une chaîne de caractères en boolean.

Parameters:

s - la chaîne

Returns:

la valeur obtenue après conversion (boolean)

true: si s est égale à "true"
false: sinon