Klasse StdIn
Die Klasse bietet verschiedene statische Methoden an, um die Standardeingabe zu lesen.
Die Methoden gliedern sich in zwei Hauptgruppen, die nicht innerhalb eines Programmes gemeinsam genutzt werden sollten.
Nicht-interaktive Eingabe (Kategorie 1)
Die nicht-interaktiven Lese-Methoden dienen ausschließlich dazu, aus Eingabeumleitungen oder Pipelines zu lesen. Sie erwarten zwingend ein Dateiende als Kennzeichnung des Endes einer Eingabe!
Interaktive Eingabe (Kategorie 2)
Die Methoden
readln*()lesen interaktive Eingaben. Eine Eingabe wird mit Return/Enter abgeschlossen.
Hinweis: Die Funktionalität und Namenskonventionen dieser Bibliothek orientieren sich an der bewährten "StdLib" der Princeton University (Sedgewick/Wayne), wurden jedoch vollständig neu und modern implementiert.
- Version:
- 1.0 (2026-10-11)
- Autor:
- Karsten Brodmann (karsten.brodmann@osnanet.de)
-
Feldübersicht
-
Methodenübersicht
Modifikator und TypMethodeBeschreibungstatic booleanPrüfung, ob noch Zeichen in der Standardeingabe vorhanden sind.static booleanPrüfung, ob noch mindestens eine Zeile in der Eingabe steht.static booleanPrüfen, ob Standardeingabe leer ist.static StringreadAll()Liest und liefert den gesamten Rest der Eingabe als einen einzigen String.static boolean[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonboolean-Werten.static byte[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonbyte-Werten.static char[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonchar-Werten.static double[]Liest und liefert den gesamten Rest der Eingabe als ein Array vondouble-Werten.static float[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonfloat-Werten.static int[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonint-Werten.static String[]Liest und liefert den gesamten Rest der Eingabe als ein Array von Zeilen.static long[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonlong-Werten.static short[]Liest und liefert den gesamten Rest der Eingabe als ein Array vonshort-Werten.static String[]Liest und liefert den gesamten Rest der Eingabe als ein Array von Strings.static booleanLiest das nächste Token in der Eingabe und gibt es alsbooleanan den Aufrufer zurück.static bytereadByte()List das nächste Token in der Eingabe und gibt es alsbytean den Aufrufer zurück.static charreadChar()Liest und liefert das nächste Zeichen aus der Standardeingabe.static doubleList das nächste Token in der Eingabe und gibt es alsdoublean den Aufrufer zurück.static floatList das nächste Token in der Eingabe und gibt es alsfloatan den Aufrufer zurück.static intreadInt()List das nächste Token in der Eingabe und gibt es alsintan den Aufrufer zurück.static StringreadLine()Liest die nächste Zeile und gibt sie an den Aufrufer zurück.static booleanInteraktives Einlesen einesboolean-Wertes.static booleanreadlnBoolean(String prompt) Interaktives Einlesen einesboolean-Wertes.static boolean[]Interaktives Einlesen einer Sequenz vonboolean-Werten.static boolean[]readlnBooleans(String prompt) Interaktives Einlesen einer Sequenz vonboolean-Werten.static byteInteraktives Einlesen einesbyte-Wertes.static bytereadlnByte(String prompt) Interaktives Einlesen einesbyte-Wertes.static byte[]Interaktives Einlesen einer Sequenz vonbyte-Werten.static byte[]readlnBytes(String prompt) Interaktives Einlesen einer Sequenz vonbyte-Werten.static char[]Interaktives Einlesen einer Sequenz von Zeichen.static char[]readlnChars(String prompt) Interaktives Einlesen einer Sequenz von Zeichen.static doubleInteraktives Einlesen einesdouble-Wertes.static doublereadlnDouble(String prompt) Interaktives Einlesen einesdouble-Wertes.static double[]Interaktives Einlesen einer Sequenz vondouble-Werten.static double[]readlnDoubles(String prompt) Interaktives Einlesen einer Sequenz vondouble-Werten.static floatInteraktives Einlesen einesfloat-Wertes.static floatreadlnFloat(String prompt) Interaktives Einlesen einesfloat-Wertes.static float[]Interaktives Einlesen einer Sequenz vonfloat-Werten.static float[]readlnFloats(String prompt) Interaktives Einlesen einer Sequenz vonfloat-Werten.static intInteraktives Einlesen einesint-Wertes.static intInteraktives Einlesen einesint-Wertes.static int[]Interaktives Einlesen einer Sequenz vonint-Werten.static int[]readlnInts(String prompt) Interaktives Einlesen einer Sequenz vonint-Werten.static StringInteraktives Einlesen einer Zeile.static StringreadlnLine(String prompt) Interaktives Einlesen einer Zeile.static longInteraktives Einlesen eineslong-Wertes.static longreadlnLong(String prompt) Interaktives Einlesen eineslong-Wertes.static long[]Interaktives Einlesen einer Sequenz vonlong-Werten.static long[]readlnLongs(String prompt) Interaktives Einlesen einer Sequenz vonlong-Werten.static shortInteraktives Einlesen einesshort-Wertes.static shortreadlnShort(String prompt) Interaktives Einlesen einesshort-Wertes.static short[]Interaktives Einlesen einer Sequenz vonshort-Werten.static short[]readlnShorts(String prompt) Interaktives Einlesen einer Sequenz vonshort-Werten.static StringInteraktives Einlesen einer Zeile.static StringreadlnString(String prompt) Interaktives Einlesen eines einzelnen Strings (ohne Whitespaces).static String[]Interaktives Einlesen einer Sequenz von Strings.static String[]readlnStrings(String prompt) Interaktives Einlesen einer Sequenz von Strings.static longreadLong()List das nächste Token in der Eingabe und gibt es alslongan den Aufrufer zurück.static shortList das nächste Token in der Eingabe und gibt es alsshortan den Aufrufer zurück.static StringLiest das nächste Token in der Eingabe und gibt es alsStringan den Aufrufer zurück.static voidreset()Generierung eines neuen Scanner-Objekts für die Standardeingabe, initialisiert mit dem Standard-Charset (IO.CHARSET).static voidsetScanner(Scanner scanner) Scanner mit dem Standard-Locale (IO.LOCALE) initialisieren.
-
Methodendetails
-
reset
public static void reset()Generierung eines neuen Scanner-Objekts für die Standardeingabe, initialisiert mit dem Standard-Charset (IO.CHARSET). -
setScanner
-
hasNextToken
public static boolean hasNextToken()Prüfen, ob Standardeingabe leer ist. Eventuelle Whitespaces werden dabei ignoriert. D.h., die Eingabe ist leer, wenn keine Zeichen oder nur Whitespaces enthalten sind.- Gibt zurück:
truewenn noch Token vorhanden, sonstfalse
-
readBoolean
public static boolean readBoolean()Liest das nächste Token in der Eingabe und gibt es alsbooleanan den Aufrufer zurück.Als wahr werden
true(unabhängig von Groß-/Kleinschreibung) und 1 erkannt.false(unabhängig von Groß-/Kleinschreibung) und 0 werden als falsch interpretiert.- Gibt zurück:
- nächster
boolean - Löst aus:
InputMismatchException- wenn Token keinbooleanNoSuchElementException- wenn Standardeingabe leer
-
readByte
public static byte readByte()List das nächste Token in der Eingabe und gibt es alsbytean den Aufrufer zurück.- Gibt zurück:
- nächster
byte-Wert - Löst aus:
InputMismatchException- wenn Token keinbyteNoSuchElementException- wenn Standardeingabe leer
-
readShort
public static short readShort()List das nächste Token in der Eingabe und gibt es alsshortan den Aufrufer zurück.- Gibt zurück:
- nächster
short-Wert - Löst aus:
InputMismatchException- wenn Token keinshortNoSuchElementException- wenn Standardeingabe leer
-
readInt
public static int readInt()List das nächste Token in der Eingabe und gibt es alsintan den Aufrufer zurück.- Gibt zurück:
- nächster
int-Wert - Löst aus:
InputMismatchException- wenn Token keinintNoSuchElementException- wenn Standardeingabe leer
-
readLong
public static long readLong()List das nächste Token in der Eingabe und gibt es alslongan den Aufrufer zurück.- Gibt zurück:
- nächster
long-Wert - Löst aus:
InputMismatchException- wenn Token keinlongNoSuchElementException- wenn Standardeingabe leer
-
readFloat
public static float readFloat()List das nächste Token in der Eingabe und gibt es alsfloatan den Aufrufer zurück.- Gibt zurück:
- nächster
float-Wert - Löst aus:
InputMismatchException- wenn Token keinfloatNoSuchElementException- wenn Standardeingabe leer
-
readDouble
public static double readDouble()List das nächste Token in der Eingabe und gibt es alsdoublean den Aufrufer zurück.- Gibt zurück:
- nächster
double-Wert - Löst aus:
InputMismatchException- wenn Token keindoubleNoSuchElementException- wenn Standardeingabe leer
-
readString
Liest das nächste Token in der Eingabe und gibt es alsStringan den Aufrufer zurück.- Gibt zurück:
- nächster
String - Löst aus:
NoSuchElementException- wenn Standardeingabe leer
-
hasNextChar
public static boolean hasNextChar()Prüfung, ob noch Zeichen in der Standardeingabe vorhanden sind.- Gibt zurück:
true, wenn noch Zeichen vorhanden, sonstfalse
-
readChar
public static char readChar()Liest und liefert das nächste Zeichen aus der Standardeingabe. Vor dem Lesen solltehasNextChar()aufgerufen werden, um zu gewährleisten ein Zeichen lesen zu können.- Gibt zurück:
- das nächste Zeichen (
char) - Löst aus:
NoSuchElementException- wenn Standardeingabe leer
-
hasNextLine
public static boolean hasNextLine()Prüfung, ob noch mindestens eine Zeile in der Eingabe steht. Nutzen Sie diese Methode vor einem Aufruf vonreadLine().Auch eine Zeile, die ausschließlich aus Whitespaces besteht, ist eine Zeile.
- Gibt zurück:
truewenn noch Zeile vorhanden, sonstfalse
-
readLine
Liest die nächste Zeile und gibt sie an den Aufrufer zurück. Ein eventuell vorhandener Zeilentrenner wird entfernt.- Gibt zurück:
- nächste Zeile;
null, wenn keine Zeile vorhanden
-
readAll
Liest und liefert den gesamten Rest der Eingabe als einen einzigen String.- Gibt zurück:
- kompletter Rest der Eingabe oder einen leeren String
-
readAllLines
Liest und liefert den gesamten Rest der Eingabe als ein Array von Zeilen.- Gibt zurück:
- Array von Zeilen (
String), ggf. leeres Array
-
readAllStrings
Liest und liefert den gesamten Rest der Eingabe als ein Array von Strings.- Gibt zurück:
- Array von
String-Werten
-
readAllChars
public static char[] readAllChars()Liest und liefert den gesamten Rest der Eingabe als ein Array vonchar-Werten. Eventuell führende Whitespace-Zeichen bleiben erhalten.- Gibt zurück:
- Array von
char-Werten
-
readAllBooleans
public static boolean[] readAllBooleans()Liest und liefert den gesamten Rest der Eingabe als ein Array vonboolean-Werten.Verwendet die private Methode
makeBoolean(String). Die Methode wirft bei falschen Eingaben eineInputMismatchException.- Gibt zurück:
- Array von
boolean-Werten
-
readAllBytes
public static byte[] readAllBytes()Liest und liefert den gesamten Rest der Eingabe als ein Array vonbyte-Werten.- Gibt zurück:
- Array von
byte-Werten - Löst aus:
NumberFormatException- Token konnte nicht alsbyteinterpretiert werden
-
readAllShorts
public static short[] readAllShorts()Liest und liefert den gesamten Rest der Eingabe als ein Array vonshort-Werten.- Gibt zurück:
- Array von
short-Werten - Löst aus:
NumberFormatException- Token konnte nicht alsshortinterpretiert werden
-
readAllInts
public static int[] readAllInts()Liest und liefert den gesamten Rest der Eingabe als ein Array vonint-Werten.- Gibt zurück:
- Array von
int-Werten - Löst aus:
NumberFormatException- Token konnte nicht alsintinterpretiert werden
-
readAllLongs
public static long[] readAllLongs()Liest und liefert den gesamten Rest der Eingabe als ein Array vonlong-Werten.- Gibt zurück:
- Array von
long-Werten - Löst aus:
NumberFormatException- Token konnte nicht alslonginterpretiert werden
-
readAllFloats
public static float[] readAllFloats()Liest und liefert den gesamten Rest der Eingabe als ein Array vonfloat-Werten.- Gibt zurück:
- Array von
float-Werten - Löst aus:
NumberFormatException- Token konnte nicht alsfloatinterpretiert werden
-
readAllDoubles
public static double[] readAllDoubles()Liest und liefert den gesamten Rest der Eingabe als ein Array vondouble-Werten.- Gibt zurück:
- Array von
float-Werten - Löst aus:
NumberFormatException- Token konnte nicht alsdoubleinterpretiert werden
-
readlnLine
-
readlnLine
-
readlnString
-
readlnString
-
readlnBoolean
Interaktives Einlesen einesboolean-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
boolean-Wert - Löst aus:
InputMismatchException- wenn keinboolean-Wert
-
readlnBoolean
public static boolean readlnBoolean()Interaktives Einlesen einesboolean-Wertes.Es wird
readlnBoolean(String)verwendet. Die Methode wirft bei falscher Eingabe eineInputMismatchException.- Gibt zurück:
- gelesener
boolean-Wert
-
readlnByte
Interaktives Einlesen einesbyte-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
byte-Wert - Löst aus:
NumberFormatException- wenn keinbyte-Wert
-
readlnByte
public static byte readlnByte()Interaktives Einlesen einesbyte-Wertes.Es wird
readlnByte(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- gelesener
byte-Wert
-
readlnShort
Interaktives Einlesen einesshort-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
short-Wert - Löst aus:
NumberFormatException- wenn keinshort-Wert
-
readlnShort
public static short readlnShort()Interaktives Einlesen einesshort-Wertes.Es wird
readlnShort(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- gelesener
short-Wert
-
readlnInt
Interaktives Einlesen einesint-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
int-Wert - Löst aus:
NumberFormatException- wenn keinint-Wert
-
readlnInt
public static int readlnInt()Interaktives Einlesen einesint-Wertes.Es wird
readlnInt(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- gelesener
int-Wert
-
readlnLong
Interaktives Einlesen eineslong-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
long-Wert - Löst aus:
NumberFormatException- wenn keinlong-Wert
-
readlnLong
public static long readlnLong()Interaktives Einlesen eineslong-Wertes.Es wird
readlnLong(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- gelesener
long-Wert - Löst aus:
NumberFormatException- wenn keinlong-Wert
-
readlnFloat
Interaktives Einlesen einesfloat-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
float-Wert - Löst aus:
NumberFormatException- wenn keinfloat-Wert
-
readlnFloat
public static float readlnFloat()Interaktives Einlesen einesfloat-Wertes.Es wird
readlnFloat(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- gelesener
float-Wert
-
readlnDouble
Interaktives Einlesen einesdouble-Wertes.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- gelesener
double-Wert - Löst aus:
NumberFormatException- wenn keindouble-Wert
-
readlnDouble
public static double readlnDouble()Interaktives Einlesen einesdouble-Wertes.Es wird
readlnDouble(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- gelesener
double-Wert
-
readlnChars
Interaktives Einlesen einer Sequenz von Zeichen.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array einzelner
char-Werte
-
readlnChars
public static char[] readlnChars()Interaktives Einlesen einer Sequenz von Zeichen.- Gibt zurück:
- Array einzelner
String-Werte
-
readlnBooleans
Interaktives Einlesen einer Sequenz vonboolean-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
boolean-Werten - Löst aus:
InputMismatchException- wenn keinboolean-Wert
-
readlnBooleans
public static boolean[] readlnBooleans()Interaktives Einlesen einer Sequenz vonboolean-Werten.Es wird
readlnBooleans(String)verwendet. Die Methode wirft bei falscher Eingabe eineInputMismatchException.- Gibt zurück:
- Array von
boolean-Werten - Löst aus:
InputMismatchException- wenn keinboolean-Wert
-
readlnBytes
Interaktives Einlesen einer Sequenz vonbyte-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
byte-Werten - Löst aus:
NumberFormatException- wenn keinbyte-Wert
-
readlnBytes
public static byte[] readlnBytes()Interaktives Einlesen einer Sequenz vonbyte-Werten.Es wird
readlnBytes(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- Array von
byte-Werten - Löst aus:
NumberFormatException- wenn keinbyte-Wert
-
readlnShorts
Interaktives Einlesen einer Sequenz vonshort-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
short-Werten - Löst aus:
NumberFormatException- wenn keinshort-Wert
-
readlnShorts
public static short[] readlnShorts()Interaktives Einlesen einer Sequenz vonshort-Werten.Es wird
readlnShorts(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- Array von
short-Werten - Löst aus:
NumberFormatException- wenn keinshort-Wert
-
readlnInts
Interaktives Einlesen einer Sequenz vonint-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
int-Werten - Löst aus:
NumberFormatException- wenn keinint-Wert
-
readlnInts
public static int[] readlnInts()Interaktives Einlesen einer Sequenz vonint-Werten.Es wird
readlnInts(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- Array von
int-Werten - Löst aus:
NumberFormatException- wenn keinint-Wert
-
readlnLongs
Interaktives Einlesen einer Sequenz vonlong-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
long-Werten - Löst aus:
NumberFormatException- wenn keinlong-Wert
-
readlnLongs
public static long[] readlnLongs()Interaktives Einlesen einer Sequenz vonlong-Werten.Es wird
readlnLongs(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- Array von
long-Werten - Löst aus:
NumberFormatException- wenn keinlong-Wert
-
readlnFloats
Interaktives Einlesen einer Sequenz vonfloat-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
float-Werten - Löst aus:
NumberFormatException- wenn keinfloat-Wert
-
readlnFloats
public static float[] readlnFloats()Interaktives Einlesen einer Sequenz vonfloat-Werten.Es wird
readlnFloats(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- Array von
float-Werten - Löst aus:
NumberFormatException- wenn keinfloat-Wert
-
readlnDoubles
Interaktives Einlesen einer Sequenz vondouble-Werten.- Parameter:
prompt- Eingabeaufforderung- Gibt zurück:
- Array von
double-Werten - Löst aus:
NumberFormatException- wenn keindouble-Wert
-
readlnDoubles
public static double[] readlnDoubles()Interaktives Einlesen einer Sequenz vondouble-Werten.Es wird
readlnDoubles(String)verwendet. Die Methode wirft bei falscher Eingabe eineNumberFormatException.- Gibt zurück:
- Array von
double-Werten - Löst aus:
NumberFormatException- wenn keindouble-Wert
-
readlnStrings
-
readlnStrings
Interaktives Einlesen einer Sequenz von Strings.- Gibt zurück:
- Array einzelner
String-Werte
-