/***********************************************************
    SWIO.java
    Sigrid Wehner's Input/Output-Routinen

    nach der Klasse IntIO aus dem Buch:
    Otto Rauh (2000), Objektorientierte Programmierung 
    in JAVA. 2. Auflage, Vieweg Braunschweig, S. 242-245.
    
    Autorin:      Sigrid Wehner
    Betr.system:  Suse Linux
    Stand:        30.4.2002
 **********************************************************/

package SWjtools;
import java.io.*;

/**  <b>Sigrid Wehner's Input/Output-Routinen</b>  <br>
*    nach der Klasse IntIO aus dem Buch: <br>
*    Otto Rauh (2000), Objektorientierte Programmierung 
*    in JAVA. 2. Auflage, Vieweg Braunschweig, S. 242-245.
*    @author:  Sigrid Wehner
*    @version: 30.4.2002
*/

public class SWIO
{
  public SWIO()
  { keyb = new BufferedReader(new InputStreamReader(System.in));
  } 


// ***** LEERZEILEN UND STERNE ***************************************

/** Gibt 1 Leerzeile aus. 
*/
  public void leerzeile()
  { 
     System.out.println();
     System.out.flush();
  }

/** Gibt mehrere Leerzeilen aus.
*   @param n Anzahl der gew&uuml;nschten Leerzeilen 
*/
  public void leern(int n)
  {
     for(int i=0; i<n;i++) leerzeile();
  }

/** Gibt eine Zeile mit Sternen aus.
*/
  public void sterne()
  { 
   this.write("********************");
   System.out.println
   ("************************************************************");    
   System.out.flush();   }



// **** AUSGABEROUTINEN **********************************************

/** Gibt einen String aus. 
*   @param s auszugebender String
*/
  public void write(String s)
  { 
   System.out.print(s);
   System.out.flush();
  }

/** Gibt eine ganze Zahl aus.
*   @param i auszugebende ganze Zahl
*/
  public void write(int i)
  { 
   System.out.print(i);
   System.out.flush();
  }

/** Gibt eine Double-Zahl aus.
*   @param z auszugebende Double-Zahl
*/
  public void write(double z)
  { 
   System.out.print(z);
   System.out.flush();
  }

/** Gibt einen String aus mit anschliessendem Zeilenvorschub.
*   @param s auszugebender String
*/
  public void writeln(String s)
  { 
   System.out.println(s);
   System.out.flush();
  }

/** Gibt eine ganze Zahl aus mit anschliessendem Zeilenvorschub.
*   @param i auszugebende ganze Zahl
*/
  public void writeln(int i)
  { 
   System.out.println(i);
   System.out.flush();
  }

/** Gibt eine Double-Zahl aus mit anschliessendem Zeilenvorschub.
*   @param z auszugebende Double-Zahl
*/
  public void writeln(double z)
  { 
   System.out.println(z);
   System.out.flush();
  }


// ***** PROMPT & READ ROUTINEN **************************************

/** Gibt einen String aus und liest anschliessend einen vom Benutzer
*   einzugebenden String ein.
*   @param s auszugebender String
*   @return vom Benutzer eingegebener String
*/
  public String promptAndReadString(String s) throws IOException
  { 
  this.write(s);
  return keyb.readLine();
  }

/** Gibt einen String aus und liest anschliessend einen 
*   Buchstaben ein.
*   @param s auszugebender String
*   @return vom Benutzer eingegebener Buchstabe
*/ 
  public char promptAndReadChar(String s)throws IOException
  { 
   this.write(s);
   return (keyb.readLine()).charAt(0);
  }

/** Gibt einen String aus und liest anschliessend eine vom
*   Benutzer eingegebene ganze Zahl ein.
*   @param s auszugebender String
*   @return vom Benutzer eingegebene ganze Zahl
*/ 
  public int promptAndReadInt(String s) throws IOException
  { 
   this.write(s);
   Integer i = new Integer(keyb.readLine());
   return i.intValue();
   }

/** Gibt einen String aus und liest anschliessend eine vom
*   Benutzer eingegebene Double-Zahl ein.
*   @param s auszugebender String
*   @return vom Benutzer eingegebene Double-Zahl
*/ 
  public double promptAndReadDouble(String s) throws IOException
  { 
   return (new Double(this.promptAndReadString(s)).doubleValue());
  }

/** Gibt den String s aus und liest einen  Buchstaben ein.
*   Ist dieser "j" oder "J" wird der Wert true
*   zur&uuml;ckgegeben.
*   @param s auszugebender String
*   @return true, falls Benutzer "j" oder "J" eingegeben hat
*/
  public boolean yesno(String s)throws IOException
  { 
   this.write(s);
   this.write("      [ja/nein? Eingabe:  j oder n ]");
   char antwort=this.promptAndReadChar(": ");
   if (antwort=='j' | antwort == 'J' ) return true;
       else return false;
  }

/**  <b>nur f&uuml;r MATRIX-Programme</b> <br>
*    Gibt den String s aus und liest anschliessend eine vom
*    Benutzer eingegebene Double-Zahl ein zum Matrix-Auff&uuml;llen.
*    @param s auszugebender String
*/
   public double promptAndReadMatrix(String s) throws IOException
  { 
   return (new Double(this.MatrixString(s)).doubleValue());
  }

/**  <b>nur f&uuml;r MATRIX-Programme</b>  <br>
*    Gibt den String s aus und liest anschliessend einen vom
*    Benutzer eingegebenen String ein.
*    @param s auszugebender String
*/
  public String MatrixString(String s) throws IOException
  { 
  this.write(s);
  return keyb.readLine();
  }



// ***** UTILITIES ***********************************************

/** Gibt eine Startzeile f&uuml;r ein Programm aus mit dem im
*   String &uuml;bergebenen Namen.
*   @param s Name des Programms in der Startzeile
*/

  public void kopf(String s)
  { /* gibt Startzeile fuer Programm mit dem im String uebergebenen
       Namen aus
       --------------------------------------------------------- */
   this.leerzeile();
   this.write("// Start des Programms ");
   this.write(s);
   this.writeln(" ...");
   this.leerzeile();   
   }
        
/** Gibt eine Verabschiedung f&uuml;r ein Programm aus mit dem im
*   String &uuml;bergebenen Namen.
*   @param s Name des Programms 
*/
  public void fuss(String s)
  { /* gibt Fusszeile fuer Programm mit dem im String uebergebenen
       Namen aus
       --------------------------------------------------------- */
   this.leerzeile();
   this.write("// Ende des Programms ");
   this.write(s);
   this.writeln(" .");
   this.writeln("// Vielen Dank fuer Ihr Vertrauen !!!");
   this.leerzeile();   
   }




  private BufferedReader keyb;
}