Package de.pakad.tools
Class StdIn
java.lang.Object
de.pakad.tools.StdIn
Die Klasse
StdIn
stellt statische Methoden für die Eingabe von der
Standardeingabe zur Verfügung.
Die Klasse stellt eine Abstraktion des in Java bereits implementierten Modells für Ein- und Ausgabe dar. Die Implementierung ist motiviert durch die AlgoTools von Prof. Dr. Oliver Vornberger.
Die Methoden für das Lesen bilden Gruppen:
- Lesen einzelner Werte:
- Lesen einzelner Zeichen:
- Zeilenweises Lesen:
- gesamte Standardeingabe auf einmal lesen:
readChars()
readlnChars()
(mit und ohne Eingabeprompt)readInts()
(mit und ohne Eingabeprompt)readBytes()
readShorts()
readInts()
readLongs()
readFloats()
readDoubles()
readIntsW()
readLongsW()
readFloatsW()
readDoublesW()
readWords()
readLines()
readAll()
readlnChars()
,readlnChars(String)
readlnWords()
,readlnWords(String)
COPYRIGHT BY Karsten Brodmann 2022 - Die Bibliothek darf ausschließlich für private Lernzwecke verwendet werden. Eine Weitergabe ist nur mit schriftlicher Genehmigung des Autors gestattet.
- Version:
- 1.0
- Author:
- Karsten Brodmann (kb@punkt-akademie.de)
-
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
Lieferttrue
, wenn noch Zeichen (inklusive Leer- und Trennzeichen) in der Standardeingabe stehen.static boolean
Lieferttrue
, wenn noch eine Zeile aus der Standardeingabe gelesen werden kann (inkl.static boolean
isEmpty()
Lieferttrue
, wenn noch Zeichen in der Standardeingabe vorhanden sind, die keine Leer- oder Trennzeichen sind.static String
readAll()
Liest die gesamte Standardeingabe und gibt sie alsString
zurück.static boolean
Liest das nächste Element aus der Standardeingabe, interpretiert es als Wahrheitswert (boolean
) und gibt den Wert zurück.static byte
readByte()
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (byte
) und gibt den Wert zurück.static byte
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (byte
) und gibt den Wert zurück.static byte[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsbyte
und liefert sie als Array vonbyte
zurück.static char
readChar()
Liest das nächste Zeichen aus der Standardeingabe und gibt es zurück.static char[]
Liest alle verbliebenen Elemente aus der Standardeingabe und liefert sie als Array vonchar
zurück.static double
Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (double
) und gibt den Wert zurück.static double
readDouble
(String prompt) Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (double
) und gibt den Wert zurück.static double[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsdouble
und liefert sie als Array vondouble
zurück.static Double[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsdouble
und liefert sie als Array vonDouble
zurück.static float
Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (float
) und gibt den Wert zurück.static float
Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (float
) und gibt den Wert zurück.static float[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsfloat
und liefert sie als Array vonfloat
zurück.static Float[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsfloat
und liefert sie als Array vonFloat
zurück.static int
readInt()
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (int
) und gibt den Wert zurück.static int
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (int
) und gibt den Wert zurück.static int[]
readInts()
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsint
und liefert sie als Array vonint
zurück.static Integer[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsint
und liefert sie als Array vonInteger
zurück.static String
readLine()
Liest die nächste Zeile und gibt sie ohne abschließenden Zeilenumbruch als Zeichenkette (String
) zurück.static String[]
Liest alle verbliebenen Zeilen aus der Standardeingabe und gibt sie als Array von Zeichenketten (String
) zurück.static char[]
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonchar
zurück.static char[]
readlnChars
(String prompt) Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonchar
zurück.static int[]
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonint
zurück.static int[]
readlnInts
(String prompt) Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonint
zurück.static String[]
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonString
zurück.static String[]
readlnWords
(String prompt) Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonString
zurück.static long
readLong()
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (long
) und gibt den Wert zurück.static long
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (long
) und gibt den Wert zurück.static long[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alslong
und liefert sie als Array vonlong
zurück.static Long[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alslong
und liefert sie als Array vonLong
zurück.static short
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (short
) und gibt den Wert zurück.static short
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (short
) und gibt den Wert zurück.static short[]
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsshort
und liefert sie als Array vonshort
zurück.static String
Liest das nächste Element aus der Standardeingabe und gibt es alsString
zurück.static String
readString
(String prompt) Liest das nächste Element aus der Standardeingabe und gibt es alsString
zurück.static String[]
Liest alle verbliebenen Elemente aus der Standardeingabe und gibt sie als Array von Worten/Zeichenketten (String
) zurück.
-
Method Details
-
isEmpty
public static boolean isEmpty()Lieferttrue
, wenn noch Zeichen in der Standardeingabe vorhanden sind, die keine Leer- oder Trennzeichen sind.- Returns:
true
wenn noch Nicht-Leerzeichen in der Standardeingabe vorhanden sind; sonstfalse
-
hasNextChar
public static boolean hasNextChar()Lieferttrue
, wenn noch Zeichen (inklusive Leer- und Trennzeichen) in der Standardeingabe stehen.- Returns:
true
wenn noch Zeichen (inklusive Leer- und Trennzeichen) in der Standardeingabe stehen; sonstfalse
-
readChar
public static char readChar()Liest das nächste Zeichen aus der Standardeingabe und gibt es zurück.- Returns:
- nächstes Zeichen (
char
) - Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readString
Liest das nächste Element aus der Standardeingabe und gibt es alsString
zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- das nächste Element
String
- Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readString
Liest das nächste Element aus der Standardeingabe und gibt es alsString
zurück.- Returns:
- das nächste Element
String
- Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readAll
Liest die gesamte Standardeingabe und gibt sie alsString
zurück.- Returns:
- gesamte Standardeingabe als
String
- Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readByte
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (byte
) und gibt den Wert zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- nächste ganze Zahl (
byte
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsbyte
interpretiert werden kann
-
readByte
public static byte readByte()Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (byte
) und gibt den Wert zurück.- Returns:
- nächste ganze Zahl (
byte
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsbyte
interpretiert werden kann
-
readShort
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (short
) und gibt den Wert zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- nächste ganze Zahl (
short
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsshort
interpretiert werden kann
-
readShort
public static short readShort()Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (short
) und gibt den Wert zurück.- Returns:
- nächste ganze Zahl (
short
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsshort
interpretiert werden kann
-
readInt
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (int
) und gibt den Wert zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- nächste ganze Zahl (
int
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsint
interpretiert werden kann
-
readInt
public static int readInt()Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (int
) und gibt den Wert zurück.- Returns:
- nächste ganze Zahl (
int
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsint
interpretiert werden kann
-
readLong
Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (long
) und gibt den Wert zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- nächste ganze Zahl (
long
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alslong
interpretiert werden kann
-
readLong
public static long readLong()Liest das nächste Element aus der Standardeingabe, interpretiert es als ganze Zahl (long
) und gibt den Wert zurück.- Returns:
- nächste ganze Zahl (
long
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alslong
interpretiert werden kann
-
readFloat
Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (float
) und gibt den Wert zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- nächste Gleitkommazahl (
float
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsfloat
interpretiert werden kann
-
readFloat
public static float readFloat()Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (float
) und gibt den Wert zurück.- Returns:
- nächste Gleitkommazahl (
float
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsfloat
interpretiert werden kann
-
readDouble
Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (double
) und gibt den Wert zurück.- Parameters:
prompt
- Eingabeaufforderung- Returns:
- nächste Gleitkommazahl (
double
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsdouble
interpretiert werden kann
-
readDouble
public static double readDouble()Liest das nächste Element aus der Standardeingabe, interpretiert es als Geitkommazahl (double
) und gibt den Wert zurück.- Returns:
- nächste Gleitkommazahl (
double
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsdouble
interpretiert werden kann
-
readBoolean
public static boolean readBoolean()Liest das nächste Element aus der Standardeingabe, interpretiert es als Wahrheitswert (boolean
) und gibt den Wert zurück. Als Wahrheitswerte werdentrue
,false
(unabhängig von Groß-/Kleinschreibung),1
(wahr) und0
(falsch) akzeptiert.- Returns:
- nächster Wahrheitswert (
boolean
) aus Standardeingabe - Throws:
NoSuchElementException
- wenn Standardeingabe leerInputMismatchException
- wenn Element nicht alsboolean
interpretiert werden kann
-
hasNextLine
public static boolean hasNextLine()Lieferttrue
, wenn noch eine Zeile aus der Standardeingabe gelesen werden kann (inkl. Leer- und Trennzeichen).- Returns:
true
wenn noch Zeichen vorhanden sind; sonstfalse
-
readLine
Liest die nächste Zeile und gibt sie ohne abschließenden Zeilenumbruch als Zeichenkette (String
) zurück.- Returns:
- nächste Zeile (ohne Zeilentrenner) (
String
),null
sonst, wenn keine nächste Zeile vorhanden
-
readWords
Liest alle verbliebenen Elemente aus der Standardeingabe und gibt sie als Array von Worten/Zeichenketten (String
) zurück. Führende Leerzeichen werden ignoriert.- Returns:
- Array von Zeichenketten (
String
) aller verbliebenen Elemente
-
readLines
Liest alle verbliebenen Zeilen aus der Standardeingabe und gibt sie als Array von Zeichenketten (String
) zurück.- Returns:
- Array von Zeichenketten (
String
) aller verbliebenen Zeilen
-
readBytes
public static byte[] readBytes()Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsbyte
und liefert sie als Array vonbyte
zurück.- Returns:
- Array von ganzen Zahlen (
byte
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsbyte
interpretiert werden kann
-
readShorts
public static short[] readShorts()Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsshort
und liefert sie als Array vonshort
zurück.- Returns:
- Array von ganzen Zahlen (
short
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsshort
interpretiert werden kann
-
readInts
public static int[] readInts()Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsint
und liefert sie als Array vonint
zurück.- Returns:
- Array von ganzen Zahlen (
int
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsint
interpretiert werden kann
-
readIntsW
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsint
und liefert sie als Array vonInteger
zurück.- Returns:
- Array von ganzen Zahlen (
Integer
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsint
interpretiert werden kann
-
readLongs
public static long[] readLongs()Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alslong
und liefert sie als Array vonlong
zurück.- Returns:
- Array von ganzen Zahlen (
long
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alslong
interpretiert werden kann
-
readLongsW
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alslong
und liefert sie als Array vonLong
zurück.- Returns:
- Array von ganzen Zahlen (
Long
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alslong
interpretiert werden kann
-
readFloats
public static float[] readFloats()Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsfloat
und liefert sie als Array vonfloat
zurück.- Returns:
- Array von ganzen Zahlen (
float
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsfloat
interpretiert werden kann
-
readFloatsW
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsfloat
und liefert sie als Array vonFloat
zurück.- Returns:
- Array von ganzen Zahlen (
Float
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsfloat
interpretiert werden kann
-
readDoubles
public static double[] readDoubles()Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsdouble
und liefert sie als Array vondouble
zurück.- Returns:
- Array von ganzen Zahlen (
double
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsdouble
interpretiert werden kann
-
readDoublesW
Liest alle verbliebenen Elemente aus der Standardeingabe, interpretiert sie alsdouble
und liefert sie als Array vonDouble
zurück.- Returns:
- Array von ganzen Zahlen (
double
) aller verbliebenen Elemente - Throws:
InputMismatchException
- wenn ein Element nicht alsDouble
interpretiert werden kann
-
readChars
public static char[] readChars()Liest alle verbliebenen Elemente aus der Standardeingabe und liefert sie als Array vonchar
zurück.- Returns:
- Array von Zeichen (
long
) aller verbliebenen Elemente - Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readlnChars
public static char[] readlnChars()Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonchar
zurück.- Returns:
- Array von Zeichen (
char
) aller verbliebenen Elemente - Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readlnChars
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonchar
zurück. Vorher wird ein Eingabeprompt ausgegeben.- Parameters:
prompt
- Eingabeprompt- Returns:
- Array von Zeichen (
char
) aller verbliebenen Elemente - Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readlnInts
public static int[] readlnInts()Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonint
zurück.- Returns:
- Array von Zeichen (
int
) aller verbliebenen Elemente - Throws:
NumberFormatException
- wenn ein Element nicht alsint
interpretiert werden kann
-
readlnInts
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonint
zurück. Vorher wird ein Eingabeprompt ausgegeben.- Parameters:
prompt
- Eingabeprompt- Returns:
- Array von Zeichen (
int
) aller verbliebenen Elemente - Throws:
NumberFormatException
- wenn ein Element nicht alsint
interpretiert werden kann
-
readlnWords
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonString
zurück.- Returns:
- Array von Zeichenketten (
String
) aller verbliebenen Elemente - Throws:
NoSuchElementException
- wenn Standardeingabe leer
-
readlnWords
Liest eine Zeile aus der Standardeingabe und liefert sie als Array vonString
zurück. Vorher wird ein Eingabeprompt ausgegeben.- Parameters:
prompt
- Eingabeprompt- Returns:
- Array von Zeichenketten (
String
) aller verbliebenen Elemente - Throws:
NoSuchElementException
- wenn Standardeingabe leer
-