Klasse TxtFileIn

java.lang.Object
StdLib.IO
StdLib.TxtFileIn
Alle implementierten Schnittstellen:
AutoCloseable

public class TxtFileIn extends IO implements AutoCloseable
Abstraktion der Eingabe aus einer Textdatei.

Die Klasse bietet verschiedene Methoden an, um eine Textdatei zu lesen. Die Eingabe ist spätestens zum Programmende zu schließen.

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
  • Konstruktorübersicht

    Konstruktoren
    Konstruktor
    Beschreibung
    TxtFileIn(String filename)
    Konstruktor für eine Eingabe aus einer Textdatei.
  • Methodenübersicht

    Modifikator und Typ
    Methode
    Beschreibung
    void
    Schließen der Eingabe.
    boolean
    Prüfung, ob noch Zeichen in der Standardeingabe vorhanden sind.
    boolean
    Prüfung, ob noch mindestens eine Zeile in der Eingabe steht.
    boolean
    Prüfen, ob Standardeingabe leer ist.
    Liest und liefert den gesamten Rest der Eingabe als einen einzigen String.
    boolean[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von boolean-Werten.
    byte[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von byte-Werten.
    char[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von char-Werten.
    double[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von double-Werten.
    float[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von float-Werten.
    int[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von int-Werten.
    Liest und liefert den gesamten Rest der Eingabe als ein Array von Zeilen.
    long[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von long-Werten.
    short[]
    Liest und liefert den gesamten Rest der Eingabe als ein Array von short-Werten.
    Liest und liefert den gesamten Rest der Eingabe als ein Array von Strings.
    boolean
    Liest das nächste Token in der Eingabe und gibt es als boolean an den Aufrufer zurück.
    byte
    List das nächste Token in der Eingabe und gibt es als byte an den Aufrufer zurück.
    char
    Liest und liefert das nächste Zeichen aus der Standardeingabe.
    double
    List das nächste Token in der Eingabe und gibt es als double an den Aufrufer zurück.
    float
    List das nächste Token in der Eingabe und gibt es als float an den Aufrufer zurück.
    int
    List das nächste Token in der Eingabe und gibt es als int an den Aufrufer zurück.
    Liest die nächste Zeile und gibt sie an den Aufrufer zurück.
    long
    List das nächste Token in der Eingabe und gibt es als long an den Aufrufer zurück.
    short
    List das nächste Token in der Eingabe und gibt es als short an den Aufrufer zurück.
    Liest das nächste Token in der Eingabe und gibt es als String an den Aufrufer zurück.
    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
  • Konstruktordetails

    • TxtFileIn

      public TxtFileIn(String filename)
      Konstruktor für eine Eingabe aus einer Textdatei.
      Parameter:
      filename - Dateiname
  • Methodendetails

    • close

      public void close()
      Schließen der Eingabe.
      Angegeben von:
      close in Schnittstelle AutoCloseable
    • setScanner

      public void setScanner(Scanner scanner)
      Scanner mit dem Standard-Locale (IO.LOCALE) initialisieren.
      Parameter:
      scanner - das zu nutzende Scanner-Objekt
    • hasNextToken

      public 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 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 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 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 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 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 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 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 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 boolean hasNextChar()
      Prüfung, ob noch Zeichen in der Standardeingabe vorhanden sind.
      Gibt zurück:
      true, wenn noch Zeichen vorhanden, sonst false
    • readChar

      public 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 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 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 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 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 String[] readAllStrings()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von Strings.
      Gibt zurück:
      Array von String-Werten
    • readAllChars

      public 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 boolean[] readAllBooleans()
      Liest und liefert den gesamten Rest der Eingabe als ein Array von boolean-Werten.

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

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

      public 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:
      InputMismatchException - Token konnte nicht als byte interpretiert werden
    • readAllShorts

      public 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:
      InputMismatchException - Token konnte nicht als short interpretiert werden
    • readAllInts

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