Referenz: java.io.BufferedReader

Weitere aktuelle Java-Titel finden Sie bei dpunkt.

Klasse java.io.BufferedReader

1.1

java.lang.Object
   |
   +--java.io.Reader
         |
         +--java.io.BufferedReader

Deklaration

public class BufferedReader extends java.io.Reader

Beschreibung

BufferedReader ist ein gepufferter Eingabe-Stream für Unicode-Zeichen. Beim Aufruf einer read-Methode werden mehr Daten aus dem darunterliegenden Stream gelesen, als eigentlich angefordert wurden. Diese Daten werden in einem Puffer zwischengespeichert, so daß nachfolgende Leseoperationen ihre Daten aus dem Puffer beziehen, was deutliche Geschwindigkeitsvorteile bringen kann. Dieser Stream arbeitet stets auf einem anderen Reader-Objekt, aus dem er die Daten bezieht.

Konstruktoren
public	BufferedReader(Reader in)
public	BufferedReader(Reader in, int sz)

Methoden
public void	close()
public void	mark(int readAheadLimit)
public boolean	markSupported()
public int	read()
public int	read(char[] b, int off, int len)
public String	readLine()
public boolean	ready()
public void	reset()
public long	skip(long n)

Konstruktoren im Detail

public BufferedReader(Reader in)
Erzeugt einen neuen BufferedReader, der seine Daten aus in bezieht. Der Puffer hat eine voreingestellte Größe von 8.192 Zeichen.

public BufferedReader(Reader in, int sz)
Erzeugt einen neuen BufferedReader, der seine Daten aus in bezieht. Der Puffer erhält eine Größe von sz Zeichen.

Methoden im Detail

public void close()

Schließt den Stream.

Exception: IOException

Falls beim Schließen des Streams ein Fehler aufgetreten ist.

public void mark(int readAheadLimit)
Markiert die momentane Position im Stream. Nachfolgende Aufrufe von reset() springen danach wieder an diese Position. Hierdurch ist es möglich, dieselben Bytes mehrfach zu lesen. Die Marke verfällt wieder, nach dem readAheadLimit Bytes aus dem Stream gelesen wurden, unabhängig davon, ob reset() aufgerufen wurde oder nicht.
Exception: IOException

public boolean markSupported()
Liefert true, da dieser Stream Markierung unterstützt.

public int read()
Liest ein Zeichen und liefert es in der Unicode-Codierung zurück. Der Rückgabewert ist -1, falls das Ende des Streams erreicht ist.
Exception: IOException

public int read(char[] b, int off, int len)
Versucht, len Bytes aus dem Stream zu lesen und speichert sie ab dem Index off in b. Wenn beim Versuch, das erste Byte zu lesen, das Stream-Ende bereits erreicht war, ist der Rückgabewert -1, ansonsten wird die Anzahl der tatsächlich gelesenen Bytes zurückgeliefert. Wenn während des Lesevorgangs das Stream-Ende erreicht wird oder wenn im darunterliegenden Stream nur weniger als len Bytes gelesen werden können, ohne zu blockieren, kehrt die Methode zurück und liefert die Anzahl der bis dahin gelesenen Bytes.
Exception: IOException

public String readLine()
Liest eine Textzeile aus dem Stream. Als Zeilenende-Sequenz wird '\r', '\n' (UNIX) oder "\r\n" (Windows) akzeptiert.
Exception: IOException

public boolean ready()
Liefert true, wenn Daten zum Lesen aus dem Stream bereitstehen, so dass ein nachfolgender Aufruf von read() nicht blockiert, sonst false.
Exception: IOException

public void reset()

Springt im Stream auf die Position zurück, die mit dem letzten Aufruf von mark() gesetzt wurde.

Exception: IOException

Falls bisher noch keine Marke gesetzt worden ist.

public long skip(long n)
Versucht, n Bytes aus dem Stream zu überlesen, und liefert die Anzahl der tatsächlich übersrungenen Bytes. Diese kann kleiner als n sein, wenn vorzeitig das Ende des Streams erreicht wird. Fall momentan weniger als n Bytes im Stream bereitstehen, blockiert diese Methode so lange, bis n Bytes gelesen werden konnten oder das Stream-Ende erreicht ist.
Exception: IOException