15章：入出力

トップ->Java Applet入門

Java入門内検索

このページの先頭に戻る

トップページに戻る

このページの先頭に戻る
 トップページに戻る

トップ-> Java入門：15章入出力-> Reader

前ページへ　:　トップへ　:　次ページへ

4. Reader

　　Readerクラスは文字ストリームの入力用クラスの一番基底クラスになります。なお、このクラスは抽象クラスです。このクラスのサブクラスはreadとcloseの２つのabstractメソッドを実装しなければなりません。しかし、下記に紹介しているほとんどのメソッドを実装することが望まれています。

　　前述したマルチスレッドプログラムでは、銀行口座の例を挙げ、同じオブジェクトに複数のスレッドが同時にアクセスすると思わぬバグが起こることを説明しました。ストリームの読み込みも同じように、複数のスレッドが例えば1つのストリームにアクセスすると思わぬバグが発生してしまいます。Readerクラスでは同期させるオブジェクトをコンストラクタで指定することができます。しかしほとんどの場合、同期させるオブジェクトはReaderクラスのオブジェクト自体であることが多いので、引数をとらないコンストラクタの場合は、同期するオブジェクトはReaderクラスのオブジェクト自体になります。

import java.io.Reader

コンストラクタ

protected Reader()
　　　　　　そのクリティカルなセクションがリーダ自体で同期する、新しい文字ストリームリーダを作成します。

protected Reader(Object lock)
　　　　　　そのクリティカルなセクションが指定されたオブジェクトで同期する、新しい文字ストリームリーダを作成します。

メソッド

abstract void close() throws IOException
　　　　そのストリームをクローズします。
　　　　入出力エラーのときにIOExceptionが投げられます。

boolean ready() throws IOException
　　　　そのストリームが読み込み可能かを確認します。
　　　　読み込み可能ならtrueが返されます。
　　　　オブジェクトがロックされているなど読み込みの準備がされていない可能性がある場合にはfalseが返されます。しかしこの場合必ず次のreadが失敗するとは限りません。
　　　　入出力エラーのときにIOExceptionが投げられます。

long skip(long n)() throws IOException
　　　　n文字分読み込み位置を後方にずらします。
　　　　実際にスキップした文字数が戻り値として返されます。
　　　　nがマイナスのときにIllegalArgumentExceptionが返されます。
　　　　入出力エラーのときにIOExceptionが投げられます。

int read() throws IOException
　　　　(0x0000～0xFFFFの1文字読み込み、成功した場合は戻り値として返されます。
　　　　ストリームが空の場合は読み込むまで制御は戻ってきません。
　　　　ストリームの最後に達した場合は-1が返されます。
　　　　入出力エラーのときにIOExceptionが投げられます。

int read(char[] buf) throws IOException
　　　　文字を読み込みbufに格納します。
　　　　実際に読み込んだ文字数が戻り値に帰ります。
　　　　ストリームの最後に達した場合は-1が返されます。
　　　　ストリームが空の場合は読み込むまで制御は戻ってきません。
　　　　入出力エラーのときにIOExceptionが投げられます。

int read(char[] buf, int off, int len) throws IOException
　　　　len文字読み込みbufのoff番目以降に格納します。
　　　　実際に読み込んだ文字数が戻り値に帰ります。
　　　　ストリームの最後に達した場合は-1が返されます。
　　　　ストリームが空の場合は読み込むまで制御は戻ってきません。
　　　　入出力エラーのときにIOExceptionが投げられます。

boolean markSupported()
　　　　markメソッドがサポートされている場合にtrueが返されます。

boolean mark(int readAheadLimit) throws IOException
　　　　サブクラスに説明をゆだねます

void reset() throws IOException
　　　　サブクラスに説明をゆだねます

前ページへ　:　トップへ　:　次ページへ