java.io
類別 FilterReader

java.lang.Object
  java.io.Reader
      java.io.FilterReader

所有已實作的介面：

Closeable, Readable

直接已知子類別：

PushbackReader

public abstract class FilterReader
extends Reader

用於讀取已過濾的字元串流的抽象類別。抽象類別 FilterReader 自身提供了一些將所有請求傳遞給所包含的串流的預設方法。FilterReader 的子類別應覆寫這些方法中的一些方法，並且還可以提供一些額外的方法和欄位。

從以下版本開始：

JDK1.1

欄位摘要

protected Reader

in 底層字元輸入串流。

從類別 java.io.Reader 繼承的欄位

lock

建構子摘要

protected

FilterReader(Reader in) 創建一個新的 filtered reader。

方法摘要

void	close() 關閉該串流並釋放與之關聯的所有資源。
void	mark(int readAheadLimit) 在串流中的當前位置上作標記。
boolean	markSupported() 判斷此串流是否支持 mark() 操作。
int	read() 讀取單個字元。
int	read(char[] cbuf, int off, int len) 將字元讀入陣列的某一部分。
boolean	ready() 判斷此串流是否已經準備好用於讀取。
void	reset() 重置該串流。
long	skip(long n) 跳過某些字元。

從類別 java.io.Reader 繼承的方法

read, read

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

in

protected Reader in

底層字元輸入串流。

建構子詳細資訊

FilterReader

protected FilterReader(Reader in)

創建一個新的 filtered reader。

參數：

in - 提供底層串流的 Reader 物件。

拋出：

NullPointerException - 如果 in 為 null

方法詳細資訊

read

public int read()
         throws IOException

讀取單個字元。

覆寫：

類別 Reader 中的 read

返回：

作為整數讀取的字元，範圍在 0 到 65535 之間 (0x00-0xffff)，如果已到達串流的末尾，則返回 -1

拋出：

IOException - 如果發生 I/O 錯誤

read

public int read(char[] cbuf,
                int off,
                int len)
         throws IOException

將字元讀入陣列的某一部分。

指定者：

類別 Reader 中的 read

參數：

cbuf - 目標緩衝區

off - 開始存儲字元處的偏移量

len - 要讀取的最多字元數

返回：

讀取的字元數，如果已到達串流的末尾，則返回 -1

拋出：

IOException - 如果發生 I/O 錯誤

skip

public long skip(long n)
          throws IOException

跳過某些字元。

覆寫：

類別 Reader 中的 skip

參數：

n - 要跳過的字元數

返回：

實際跳過的字元數

拋出：

IOException - 如果發生 I/O 錯誤

ready

public boolean ready()
              throws IOException

判斷此串流是否已經準備好用於讀取。

覆寫：

類別 Reader 中的 ready

返回：

如果保證下一個 read() 不阻塞輸入，則返回 True，否則返回 false。注意，返回 false 並不保證阻塞下一次讀取。

拋出：

IOException - 如果發生 I/O 錯誤

markSupported

public boolean markSupported()

判斷此串流是否支持 mark() 操作。

覆寫：

類別 Reader 中的 markSupported

返回：

當且僅當此串流支持此 mark 操作時，返回 true。

mark

public void mark(int readAheadLimit)
          throws IOException

在串流中的當前位置上作標記。

覆寫：

類別 Reader 中的 mark

參數：

readAheadLimit - 在仍保留該標記的情況下，對可讀取字元數量的限制。在讀取這樣多的字元後，嘗試重置串流可能會失敗。

拋出：

IOException - 如果發生 I/O 錯誤

reset

public void reset()
           throws IOException

重置該串流。

覆寫：

類別 Reader 中的 reset

拋出：

IOException - 如果發生 I/O 錯誤

close

public void close()
           throws IOException

從類別 Reader 複製的描述

關閉該串流並釋放與之關聯的所有資源。在關閉該串流後，再調用 read()、ready()、mark()、reset() 或 skip() 將拋出 IOException。關閉以前關閉的串流無效。

指定者：

介面 Closeable 中的 close

指定者：

類別 Reader 中的 close

拋出：

IOException - 如果發生 I/O 錯誤