java.io
クラス InputStreamReader

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

直接の既知のサブクラス:

FileReader

public class InputStreamReader

extends Reader

InputStreamReader はバイトストリームから文字ストリームへの橋渡しの役目を持ち、バイトデータを読み込んで、それを指定された方法で変換して文字にエンコードします。使用されるエンコーディングは、名前で指定するか、またはプラットフォームのデフォルトをそのまま使うこともできます。

InputStreamReader の read() メソッドのどれかを呼び出すたびに、基礎のバイト入力ストリームから 1 つ以上のバイトが読み込まれます。効率を最高にするには、次のような方法で、BufferedReader の内部に InputStreamReader をラップすることを考慮してください。

 BufferedReader in
   = new BufferedReader(new InputStreamReader(System.in));
 

導入されたバージョン:

JDK1.1

関連項目:

BufferedReader, InputStream

クラス java.io.Reader から継承したフィールド

lock

コンストラクタの概要

InputStreamReader(InputStream in)
デフォルトの文字エンコーディングを使う InputStreamReader を作成します。

InputStreamReader(InputStream in, String enc)
指定された文字エンコーディングを使う InputStreamReader を作成します。

メソッドの概要

void	close() ストリームを閉じます。
String	getEncoding() このストリームによって使用されている文字エンコーディングの標準名を返します。
int	read() 単一の文字を読み込みます。
int	read(char[] cbuf, int off, int len) 配列の一部に文字を読み込みます。
boolean	ready() ストリームが読み込み可能な状態かどうかを通知します。

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

mark, markSupported, read, reset, skip

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

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

コンストラクタの詳細

InputStreamReader

public InputStreamReader(InputStream in)

デフォルトの文字エンコーディングを使う InputStreamReader を作成します。

パラメータ:

in - InputStream

InputStreamReader

public InputStreamReader(InputStream in,
                         String enc)
                  throws UnsupportedEncodingException

指定された文字エンコーディングを使う InputStreamReader を作成します。

パラメータ:

in - InputStream

enc - 使用するエンコーディングの名前

例外:

UnsupportedEncodingException - 指定されたエンコーディングがサポートされていない場合

メソッドの詳細

getEncoding

public String getEncoding()

このストリームによって使用されている文字エンコーディングの標準名を返します。この InputStreamReader が InputStreamReader(InputStream, String) コンストラクタで作成された場合、返されるエンコーディング名 (標準名) はコンストラクタに渡されたエンコーディング名と異なることがあります。ストリームが閉じている場合は、null が返されることがあります。

read

public int read()
         throws IOException

単一の文字を読み込みます。

戻り値:

読み込まれた文字。ストリームの終わりに達した場合は -1

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス Reader 内の read

read

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

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

パラメータ:

cbuf - 書き込み先のバッファ

off - 文字の格納開始オフセット

len - 読み込む最大の文字数

戻り値:

読み込まれた文字数。ストリームの終わりに達した場合は -1

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス Reader 内の read

ready

public boolean ready()
              throws IOException

ストリームが読み込み可能な状態かどうかを通知します。InputStreamReader は、入力バッファが空白ではないか、または基礎バイトストリームからバイトデータを読み込める状態のときに読み込み可能です。

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス Reader 内の ready

close

public void close()
           throws IOException

ストリームを閉じます。

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス Reader 内の close