java.io
クラス InputStreamReader

java.lang.Object
  java.io.Reader
      java.io.InputStreamReader

public class InputStreamReader
extends Reader

InputStreamReader は指定された文字セットに基づいてバイトストリームを文字ストリームに変換します。

InputStreamReader はバイトを文字に変換するため、複数のバイトを読み込むことがあります。 パフォーマンスを向上させるため、 BufferedReader を使って入力バイトストリームをバッファすることを検討してください。

InputStreamReader の操作は同期化されています。

コンストラクタの概要

InputStreamReader(InputStream in)
デフォルトの文字セットに変換する InputStreamReader を生成します。

InputStreamReader(InputStream in, String charsetName)
指定された文字セットに変換する InputStreamReader を生成します。

メソッドの概要

void	close() ストリームをクローズします。
void	mark(int v) このストリーム中の現在のアクセス位置をマークします。
boolean	markSupported() このストリームが mark 操作をサポートしているかどうかをテストします。
int	read(char[] cbuf, int off, int len) 複数の文字を配列の一部分に読み込みます。
boolean	ready() このストリームから読み込み可能かどうかテストします。
void	reset() ストリームをリセットします。

クラス java.io.Reader から継承されたメソッド

read, read, skip

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

InputStreamReader

public InputStreamReader(InputStream in)

デフォルトの文字セットに変換する InputStreamReader を生成します。

パラメータ:

in - バイトストリームを読み込む InputStream

InputStreamReader

public InputStreamReader(InputStream in,
                         String charsetName)
                  throws UnsupportedEncodingException

指定された文字セットに変換する InputStreamReader を生成します。

パラメータ:

in - バイトストリームを読み込む InputStream

charsetName - 文字セットの名称

例外:

UnsupportedEncodingException - charsetName に指定された文字セットをサポートしていない場合

メソッドの詳細

close

public void close()
           throws IOException

ストリームをクローズします。

定義:

クラス Reader 内の close

例外:

IOException - I/Oエラーが発生した場合

read

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

複数の文字を配列の一部分に読み込みます。

定義:

クラス Reader 内の read

パラメータ:

cbuf - 格納先のバッファ

off - 文字をバッファに書き込み始めるオフセット位置

len - 読み込む文字の最大数。 このパラメータに0を指定した場合の振る舞いは保証されません。

戻り値:

読み込んだ文字数。 ストリームの終端に到達した場合は -1 。

例外:

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、サポートしていない場合 false

mark

public void mark(int v)
          throws IOException

このストリーム中の現在のアクセス位置をマークします。 以降 reset メソッドを呼ぶと、このストリームのアクセス位置を最後にマークされた位置にリセットします。

オーバーライド:

クラス Reader 内の mark

パラメータ:

v - マーク位置を保持したままで読み出し可能な最大文字数。 この文字数分を読みだした後にストリームをリセットすると失敗する可能性があります。

例外:

IOException - ストリームが mark をサポートしない場合、または何らかの I/O エラーが発生した場合

reset

public void reset()
           throws IOException

ストリームをリセットします。 ストリームがマークされていた場合、このメソッドは読み出し位置をマーク位置にリセットします。

オーバーライド:

クラス Reader 内の reset

例外:

IOException - ストリームが mark 、 reset をサポートしていない場合、または何らかのI/Oエラーが発生した場合