Klasse StdIn


public class StdIn extends IO
Abstraktion der Standardeingabe.

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.

  1. 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!

  2. 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

    Von Klasse geerbte Felder IO

    CHARSET, LOCALE, logger
  • Methodenübersicht

    Modifikator und Typ
    Methode
    Beschreibung
    static boolean
    Prüfung, ob noch Zeichen in der Standardeingabe vorhanden sind.
    static boolean
    Prüfung, ob noch mindestens eine Zeile in der Eingabe steht.
    static boolean
    Prüfen, ob Standardeingabe leer ist.
    static String
    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 von boolean-Werten.
    static byte[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von byte-Werten.
    static char[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von char-Werten.
    static double[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von double-Werten.
    static float[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von float-Werten.
    static int[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von int-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 von long-Werten.
    static short[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von short-Werten.
    static String[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von Strings.
    static boolean
    Liest das nächste Token in der Eingabe und gibt es als boolean an den Aufrufer zurück.
    static byte
    List das nächste Token in der Eingabe und gibt es als byte an den Aufrufer zurück.
    static char
    Liest und liefert das nächste Zeichen aus der Standardeingabe.
    static double
    List das nächste Token in der Eingabe und gibt es als double an den Aufrufer zurück.
    static float
    List das nächste Token in der Eingabe und gibt es als float an den Aufrufer zurück.
    static int
    List das nächste Token in der Eingabe und gibt es als int an den Aufrufer zurück.
    static String
    Liest die nächste Zeile und gibt sie an den Aufrufer zurück.
    static boolean
    Interaktives Einlesen eines boolean-Wertes.
    static boolean
    Interaktives Einlesen eines boolean-Wertes.
    static boolean[]
    Interaktives Einlesen einer Sequenz von boolean-Werten.
    static boolean[]
    Interaktives Einlesen einer Sequenz von boolean-Werten.
    static byte
    Interaktives Einlesen eines byte-Wertes.
    static byte
    Interaktives Einlesen eines byte-Wertes.
    static byte[]
    Interaktives Einlesen einer Sequenz von byte-Werten.
    static byte[]
    Interaktives Einlesen einer Sequenz von byte-Werten.
    static char[]
    Interaktives Einlesen einer Sequenz von Zeichen.
    static char[]
    Interaktives Einlesen einer Sequenz von Zeichen.
    static double
    Interaktives Einlesen eines double-Wertes.
    static double
    Interaktives Einlesen eines double-Wertes.
    static double[]
    Interaktives Einlesen einer Sequenz von double-Werten.
    static double[]
    Interaktives Einlesen einer Sequenz von double-Werten.
    static float
    Interaktives Einlesen eines float-Wertes.
    static float
    Interaktives Einlesen eines float-Wertes.
    static float[]
    Interaktives Einlesen einer Sequenz von float-Werten.
    static float[]
    Interaktives Einlesen einer Sequenz von float-Werten.
    static int
    Interaktives Einlesen eines int-Wertes.
    static int
    readlnInt(String prompt)
    Interaktives Einlesen eines int-Wertes.
    static int[]
    Interaktives Einlesen einer Sequenz von int-Werten.
    static int[]
    Interaktives Einlesen einer Sequenz von int-Werten.
    static String
    Interaktives Einlesen einer Zeile.
    static String
    Interaktives Einlesen einer Zeile.
    static long
    Interaktives Einlesen eines long-Wertes.
    static long
    Interaktives Einlesen eines long-Wertes.
    static long[]
    Interaktives Einlesen einer Sequenz von long-Werten.
    static long[]
    Interaktives Einlesen einer Sequenz von long-Werten.
    static short
    Interaktives Einlesen eines short-Wertes.
    static short
    Interaktives Einlesen eines short-Wertes.
    static short[]
    Interaktives Einlesen einer Sequenz von short-Werten.
    static short[]
    Interaktives Einlesen einer Sequenz von short-Werten.
    static String
    Interaktives Einlesen einer Zeile.
    static String
    Interaktives Einlesen eines einzelnen Strings (ohne Whitespaces).
    static String[]
    Interaktives Einlesen einer Sequenz von Strings.
    static String[]
    Interaktives Einlesen einer Sequenz von Strings.
    static long
    List das nächste Token in der Eingabe und gibt es als long an den Aufrufer zurück.
    static short
    List das nächste Token in der Eingabe und gibt es als short an den Aufrufer zurück.
    static String
    Liest das nächste Token in der Eingabe und gibt es als String an den Aufrufer zurück.
    static void
    Generierung eines neuen Scanner-Objekts für die Standardeingabe, initialisiert mit dem Standard-Charset (IO.CHARSET).
    static void
    Scanner mit dem Standard-Locale (IO.LOCALE) initialisieren.

    Von Klasse geerbte Methoden Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Methodendetails

    • reset

      public static void reset()
      Generierung eines neuen Scanner-Objekts für die Standardeingabe, initialisiert mit dem Standard-Charset (IO.CHARSET).
    • setScanner

      public static void setScanner(Scanner scanner)
      Scanner mit dem Standard-Locale (IO.LOCALE) initialisieren.
      Parameter:
      scanner - das zu nutzende Scanner-Objekt
    • 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:
      true wenn noch Token vorhanden, sonst false
    • readBoolean

      public static boolean readBoolean()
      Liest das nächste Token in der Eingabe und gibt es als boolean an 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 kein boolean
      NoSuchElementException - wenn Standardeingabe leer
    • readByte

      public static byte readByte()
      List das nächste Token in der Eingabe und gibt es als byte an den Aufrufer zurück.
      Gibt zurück:
      nächster byte-Wert
      Löst aus:
      InputMismatchException - wenn Token kein byte
      NoSuchElementException - wenn Standardeingabe leer
    • readShort

      public static short readShort()
      List das nächste Token in der Eingabe und gibt es als short an den Aufrufer zurück.
      Gibt zurück:
      nächster short-Wert
      Löst aus:
      InputMismatchException - wenn Token kein short
      NoSuchElementException - wenn Standardeingabe leer
    • readInt

      public static int readInt()
      List das nächste Token in der Eingabe und gibt es als int an den Aufrufer zurück.
      Gibt zurück:
      nächster int-Wert
      Löst aus:
      InputMismatchException - wenn Token kein int
      NoSuchElementException - wenn Standardeingabe leer
    • readLong

      public static long readLong()
      List das nächste Token in der Eingabe und gibt es als long an den Aufrufer zurück.
      Gibt zurück:
      nächster long-Wert
      Löst aus:
      InputMismatchException - wenn Token kein long
      NoSuchElementException - wenn Standardeingabe leer
    • readFloat

      public static float readFloat()
      List das nächste Token in der Eingabe und gibt es als float an den Aufrufer zurück.
      Gibt zurück:
      nächster float-Wert
      Löst aus:
      InputMismatchException - wenn Token kein float
      NoSuchElementException - wenn Standardeingabe leer
    • readDouble

      public static double readDouble()
      List das nächste Token in der Eingabe und gibt es als double an den Aufrufer zurück.
      Gibt zurück:
      nächster double-Wert
      Löst aus:
      InputMismatchException - wenn Token kein double
      NoSuchElementException - wenn Standardeingabe leer
    • readString

      public static String readString()
      Liest das nächste Token in der Eingabe und gibt es als String an 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, sonst false
    • readChar

      public static char readChar()
      Liest und liefert das nächste Zeichen aus der Standardeingabe. Vor dem Lesen sollte hasNextChar() 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 von readLine().

      Auch eine Zeile, die ausschließlich aus Whitespaces besteht, ist eine Zeile.

      Gibt zurück:
      true wenn noch Zeile vorhanden, sonst false
    • readLine

      public static String 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

      public static String 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

      public static 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

      public static String[] 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 von char-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 von boolean-Werten.

      Verwendet die private Methode makeBoolean(String). Die Methode wirft bei falschen Eingaben eine InputMismatchException.

      Gibt zurück:
      Array von boolean-Werten
    • readAllBytes

      public static byte[] readAllBytes()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von byte-Werten.
      Gibt zurück:
      Array von byte-Werten
      Löst aus:
      NumberFormatException - Token konnte nicht als byte interpretiert werden
    • readAllShorts

      public static short[] readAllShorts()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von short-Werten.
      Gibt zurück:
      Array von short-Werten
      Löst aus:
      NumberFormatException - Token konnte nicht als short interpretiert werden
    • readAllInts

      public static int[] readAllInts()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von int-Werten.
      Gibt zurück:
      Array von int-Werten
      Löst aus:
      NumberFormatException - Token konnte nicht als int interpretiert werden
    • readAllLongs

      public static long[] readAllLongs()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von long-Werten.
      Gibt zurück:
      Array von long-Werten
      Löst aus:
      NumberFormatException - Token konnte nicht als long interpretiert werden
    • readAllFloats

      public static float[] readAllFloats()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von float-Werten.
      Gibt zurück:
      Array von float-Werten
      Löst aus:
      NumberFormatException - Token konnte nicht als float interpretiert werden
    • readAllDoubles

      public static double[] readAllDoubles()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von double-Werten.
      Gibt zurück:
      Array von float-Werten
      Löst aus:
      NumberFormatException - Token konnte nicht als double interpretiert werden
    • readlnLine

      public static String readlnLine(String prompt)
      Interaktives Einlesen einer Zeile.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Zeile (String)
    • readlnLine

      public static String readlnLine()
      Interaktives Einlesen einer Zeile.
      Gibt zurück:
      Zeile (String)
    • readlnString

      public static String readlnString(String prompt)
      Interaktives Einlesen eines einzelnen Strings (ohne Whitespaces).
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      einzelner String (ohne Whitespaces)
    • readlnString

      public static String readlnString()
      Interaktives Einlesen einer Zeile.
      Gibt zurück:
      Zeile (String)
    • readlnBoolean

      public static boolean readlnBoolean(String prompt)
      Interaktives Einlesen eines boolean-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener boolean-Wert
      Löst aus:
      InputMismatchException - wenn kein boolean-Wert
    • readlnBoolean

      public static boolean readlnBoolean()
      Interaktives Einlesen eines boolean-Wertes.

      Es wird readlnBoolean(String) verwendet. Die Methode wirft bei falscher Eingabe eine InputMismatchException.

      Gibt zurück:
      gelesener boolean-Wert
    • readlnByte

      public static byte readlnByte(String prompt)
      Interaktives Einlesen eines byte-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener byte-Wert
      Löst aus:
      NumberFormatException - wenn kein byte-Wert
    • readlnByte

      public static byte readlnByte()
      Interaktives Einlesen eines byte-Wertes.

      Es wird readlnByte(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      gelesener byte-Wert
    • readlnShort

      public static short readlnShort(String prompt)
      Interaktives Einlesen eines short-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener short-Wert
      Löst aus:
      NumberFormatException - wenn kein short-Wert
    • readlnShort

      public static short readlnShort()
      Interaktives Einlesen eines short-Wertes.

      Es wird readlnShort(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      gelesener short-Wert
    • readlnInt

      public static int readlnInt(String prompt)
      Interaktives Einlesen eines int-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener int-Wert
      Löst aus:
      NumberFormatException - wenn kein int-Wert
    • readlnInt

      public static int readlnInt()
      Interaktives Einlesen eines int-Wertes.

      Es wird readlnInt(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      gelesener int-Wert
    • readlnLong

      public static long readlnLong(String prompt)
      Interaktives Einlesen eines long-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener long-Wert
      Löst aus:
      NumberFormatException - wenn kein long-Wert
    • readlnLong

      public static long readlnLong()
      Interaktives Einlesen eines long-Wertes.

      Es wird readlnLong(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      gelesener long-Wert
      Löst aus:
      NumberFormatException - wenn kein long-Wert
    • readlnFloat

      public static float readlnFloat(String prompt)
      Interaktives Einlesen eines float-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener float-Wert
      Löst aus:
      NumberFormatException - wenn kein float-Wert
    • readlnFloat

      public static float readlnFloat()
      Interaktives Einlesen eines float-Wertes.

      Es wird readlnFloat(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      gelesener float-Wert
    • readlnDouble

      public static double readlnDouble(String prompt)
      Interaktives Einlesen eines double-Wertes.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      gelesener double-Wert
      Löst aus:
      NumberFormatException - wenn kein double-Wert
    • readlnDouble

      public static double readlnDouble()
      Interaktives Einlesen eines double-Wertes.

      Es wird readlnDouble(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      gelesener double-Wert
    • readlnChars

      public static char[] readlnChars(String prompt)
      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

      public static boolean[] readlnBooleans(String prompt)
      Interaktives Einlesen einer Sequenz von boolean-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von boolean-Werten
      Löst aus:
      InputMismatchException - wenn kein boolean-Wert
    • readlnBooleans

      public static boolean[] readlnBooleans()
      Interaktives Einlesen einer Sequenz von boolean-Werten.

      Es wird readlnBooleans(String) verwendet. Die Methode wirft bei falscher Eingabe eine InputMismatchException.

      Gibt zurück:
      Array von boolean-Werten
      Löst aus:
      InputMismatchException - wenn kein boolean-Wert
    • readlnBytes

      public static byte[] readlnBytes(String prompt)
      Interaktives Einlesen einer Sequenz von byte-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von byte-Werten
      Löst aus:
      NumberFormatException - wenn kein byte-Wert
    • readlnBytes

      public static byte[] readlnBytes()
      Interaktives Einlesen einer Sequenz von byte-Werten.

      Es wird readlnBytes(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      Array von byte-Werten
      Löst aus:
      NumberFormatException - wenn kein byte-Wert
    • readlnShorts

      public static short[] readlnShorts(String prompt)
      Interaktives Einlesen einer Sequenz von short-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von short-Werten
      Löst aus:
      NumberFormatException - wenn kein short-Wert
    • readlnShorts

      public static short[] readlnShorts()
      Interaktives Einlesen einer Sequenz von short-Werten.

      Es wird readlnShorts(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      Array von short-Werten
      Löst aus:
      NumberFormatException - wenn kein short-Wert
    • readlnInts

      public static int[] readlnInts(String prompt)
      Interaktives Einlesen einer Sequenz von int-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von int-Werten
      Löst aus:
      NumberFormatException - wenn kein int-Wert
    • readlnInts

      public static int[] readlnInts()
      Interaktives Einlesen einer Sequenz von int-Werten.

      Es wird readlnInts(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      Array von int-Werten
      Löst aus:
      NumberFormatException - wenn kein int-Wert
    • readlnLongs

      public static long[] readlnLongs(String prompt)
      Interaktives Einlesen einer Sequenz von long-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von long-Werten
      Löst aus:
      NumberFormatException - wenn kein long-Wert
    • readlnLongs

      public static long[] readlnLongs()
      Interaktives Einlesen einer Sequenz von long-Werten.

      Es wird readlnLongs(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      Array von long-Werten
      Löst aus:
      NumberFormatException - wenn kein long-Wert
    • readlnFloats

      public static float[] readlnFloats(String prompt)
      Interaktives Einlesen einer Sequenz von float-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von float-Werten
      Löst aus:
      NumberFormatException - wenn kein float-Wert
    • readlnFloats

      public static float[] readlnFloats()
      Interaktives Einlesen einer Sequenz von float-Werten.

      Es wird readlnFloats(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      Array von float-Werten
      Löst aus:
      NumberFormatException - wenn kein float-Wert
    • readlnDoubles

      public static double[] readlnDoubles(String prompt)
      Interaktives Einlesen einer Sequenz von double-Werten.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array von double-Werten
      Löst aus:
      NumberFormatException - wenn kein double-Wert
    • readlnDoubles

      public static double[] readlnDoubles()
      Interaktives Einlesen einer Sequenz von double-Werten.

      Es wird readlnDoubles(String) verwendet. Die Methode wirft bei falscher Eingabe eine NumberFormatException.

      Gibt zurück:
      Array von double-Werten
      Löst aus:
      NumberFormatException - wenn kein double-Wert
    • readlnStrings

      public static String[] readlnStrings(String prompt)
      Interaktives Einlesen einer Sequenz von Strings.
      Parameter:
      prompt - Eingabeaufforderung
      Gibt zurück:
      Array einzelner String-Werte
    • readlnStrings

      public static String[] readlnStrings()
      Interaktives Einlesen einer Sequenz von Strings.
      Gibt zurück:
      Array einzelner String-Werte