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

Deklaration

Beschreibung

Datenelemente im Detail

protected Object lock

Sperre für das Objekt.

Konstruktoren im Detail

protected Reader()

Erzeugt ein neues Reader-Objekt, das sich selbst als Mutex zur Mehrfachzugriffskoordination verwendet.

protected Reader(Object lock)

Erzeugt ein neues Reader-Objekt, das das Objekt lock als Mutex zur Mehrfachzugriffskoordination verwendet.

Methoden im Detail

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

• Falls der Stream keine Markierung unterstützt.

public boolean markSupported()

Liefert true, wenn der Stream Markierung unterstützt, sonst false.

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

• Falls beim Lesen ein Fehler aufgetreten ist.

public int read(char[] b)

Versucht, b.length Zeichen aus dem Stream zu lesen und speichert sie in b. Wenn beim Versuch, das erste Zeichen zu lesen, das Dateiende bereits erreicht ist, ist der Rückgabewert -1. Ansonsten wird die Anzahl der tatsächlich gelesenen Bytes zurückgeliefert.

Exception: IOException

• Falls beim Lesen ein Fehler aufgetreten ist.

public abstract int read(char[] b, int off, int len)

Versucht, len Zeichen aus dem Stream zu lesen und speichert sie ab dem Index off in b. Wenn beim Versuch, das erste Zeichen zu lesen, das Dateiende bereits erreicht ist, 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. Diese Variante muß in den Unterklassen überschrieben werden.

Exception: IOException

• Falls beim Lesen ein Fehler aufgetreten ist.

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() markiert wurde.

Exception: IOException

• Falls keine Marke gesetzt wurde oder eine gesetzte Marke verfallen ist.
• Wenn der Stream keine Markierung unterstützt.
• Falls beim Zurücksetzen ein Fehler auftritt.

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

• Falls beim Lesen ein Fehler aufgetreten ist.