Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
(日本語版)

java.io
クラス InputStreamReader

java.lang.Object
  上位を拡張 java.io.Reader
      上位を拡張 java.io.InputStreamReader

public class InputStreamReader
extends Reader

バイトによる入力を行う InputStream クラスと文字による入力を行う Reader クラスの仲立的な処理を持ったクラスです。 入力ストリームと必要に応じて文字エンコーディング名を渡すと、渡した入力ストリームから Reader クラスの規約に従った読み出しを行えます。 この際の文字エンコーディングは、文字エンコーディングを指定しなかった場合はプラットフォームに依存したデフォルトの文字エンコーディングを使用します。 文字エンコーディングを指定した場合はその文字エンコーディングを使用します。

このクラスと逆に OutputStream クラスと文字による出力を行う Writer クラスの仲立ち的な処理を行う OutputStreamWriter クラスが用意されています。

導入されたバージョン:
CLDC 1.0
関連項目:
InputStream, OutputStreamWriter, System.getProperty(java.lang.String)

フィールドの概要
 
クラス java.io.Reader から継承されたフィールド
lock
 
コンストラクタの概要
InputStreamReader(InputStream is)
          入力ストリームを受け取ってオブジェクトを構築します。
InputStreamReader(InputStream is, String encoding)
          入力ストリームと文字エンコーディング名を受け取ってオブジェクトを構築します。
 
メソッドの概要
 void close()
          ストリームをクローズし、関連するリソースを全て開放します。
 void mark(int size)
          ストリームが指している現在位置をマークします。
 boolean markSupported()
          ストリームが mark(int) メソッドと reset() メソッドによる操作に対応しているか否かを返します。
 int read()
          文字を1つ読み出します。
 int read(char[] data, int index, int length)
          ストリームから指定された数の文字を渡された char 配列の指定位置へ読み出します。
 boolean ready()
          ストリームから文字をブロックせずに読み出せるか否かを返します。
 void reset()
          ストリームが次回文字を読み出す位置を、最後に mark(int) メソッドによってマークした位置あるいは実装に固有な規定位置に戻します。
 long skip(long length)
          ストリームから指定された数の文字を読み飛ばします。
 
クラス java.io.Reader から継承されたメソッド
read
 
クラス java.lang.Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

InputStreamReader

public InputStreamReader(InputStream is)

入力ストリームを受け取ってオブジェクトを構築します。 文字エンコーディングはプラットフォームのデフォルトを使用します。

パラメータ:
is - 処理を行う対象の入力ストリームを渡します。
関連項目:
System.getProperty(String)

InputStreamReader

public InputStreamReader(InputStream is,
                         String encoding)
                  throws UnsupportedEncodingException

入力ストリームと文字エンコーディング名を受け取ってオブジェクトを構築します。 指定された文字エンコーディングをサポートしていない場合は UnsupportedEncodingException を throw します。

パラメータ:
is - 処理を行う対象の入力ストリームを渡します。
encoding - 使用する文字エンコーディング名を渡します。
例外:
UnsupportedEncodingException - 指定された文字エンコーディング名をサポートしていない場合に throw します。
メソッドの詳細

read

public int read()
         throws IOException

文字を1つ読み出します。 このメソッドは文字の読み出しが終了するか、例外が throw されるかあるいは終端に達するまでブロックします。

オーバーライド:
クラス Reader 内の read
戻り値:
読み出した1文字を int 型の値(0x00000xffff)として返します。これは読み出した char 型の値を int 型でキャストした値を取得するのと等価です。
例外:
IOException - データの読み出し時に何らかの障害が発生した場合に throw します。
関連項目:
OutputStreamWriter.write(int)

read

public int read(char[] data,
                int index,
                int length)
         throws IOException

ストリームから指定された数の文字を渡された char 配列の指定位置へ読み出します。 このメソッドは指定された数の文字の読み出しを完了するか、ストリームが終端に達するかあるいは例外が throw されるまでブロックします。

定義:
クラス Reader 内の read
パラメータ:
data - 読み出した文字列を書き込む char 配列を渡します。
index - 読み出した文字列を書き込み開始する char 配列の位置を渡します。
length - 読み出す文字数を渡します。
戻り値:
読み出した文字数あるいは -1 を返します。
例外:
IOException - 初回の文字読み出しがストリームが終端に達した以外の要因で読み出しに失敗した場合に throw します。
NullPointerException - datanull が渡された場合に throw します。
IndexOutOfBoundsException - index が負数あるいは index + lengthdata のサイズを超える場合に throw します。
関連項目:
OutputStreamWriter.write(char[], int, int)

skip

public long skip(long length)
          throws IOException

ストリームから指定された数の文字を読み飛ばします。 しかし、実際に読み飛ばすことのできる文字数がさまざまな要因(ストリームが終端に達するなど)によって指定された文字数に達しないこともあります。 戻り値には実際に読み飛ばした文字数を返します。

オーバーライド:
クラス Reader 内の skip
パラメータ:
length - 読み飛ばす文字数を渡します。
例外:
IOException - ストリームが終端に達した以外の要因で読み出しに失敗した場合に throw します。

ready

public boolean ready()
              throws IOException

ストリームから文字をブロックせずに読み出せるか否かを返します。

オーバーライド:
クラス Reader 内の ready
戻り値:
ブロックせずに読み出すことができる場合は true を、そうではない場合は false を返します。
例外:
IOException - 判定を行う際に何らかの障害が発生した場合に throw します。

markSupported

public boolean markSupported()

ストリームが mark(int) メソッドと reset() メソッドによる操作に対応しているか否かを返します。

オーバーライド:
クラス Reader 内の markSupported
戻り値:
入力ストリームが mark(int) メソッドと reset() メソッドによる操作をサポートしている場合は true を、サポートしていない場合は false を返します。
関連項目:
mark(int), reset()

mark

public void mark(int size)
          throws IOException

ストリームが指している現在位置をマークします。 reset() メソッドを呼び出すと入力ストリームが次回文字を取り出す位置がマークした位置へ戻ります。 これにより、ストリームの特定部分を繰り返し読むことができます。

オーバーライド:
クラス Reader 内の mark
パラメータ:
size - 現在位置をマークしてから読み出される可能性のある最大バイト数を渡します。
例外:
IOException - ストリームがこのメソッドをサポートしない場合あるいは処理上何らかの障害が発生した場合に throw します。

reset

public void reset()
           throws IOException

ストリームが次回文字を読み出す位置を、最後に mark(int) メソッドによってマークした位置あるいは実装に固有な規定位置に戻します。

オーバーライド:
クラス Reader 内の reset
例外:
IOException - マークされた位置が無効となっている場合あるいはこのメソッドの操作をサポートしていない場合に throw します。
関連項目:
markSupported(), mark(int)

close

public void close()
           throws IOException

ストリームをクローズし、関連するリソースを全て開放します。

定義:
クラス Reader 内の close
例外:
IOException - 処理に伴い、入力関係で何らかの障害が発生した場合に throw します。

Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
(日本語版)

公式仕様書原文の著作権表記等(※):

Mobile Information Device Profile Specification ("Specification")
Version: 2.0
Status: FCS
Release: November 5, 2002

Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc.
All rights reserved.
※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。

※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます(第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います)。

この API リファレンスは仕様書の日本語版という位置づけでは作成していませんし、仕様書ほど厳格でもありません。MUST、SHOULD、MAY などの仕様の条件を強調する文を維持していません(反映すらしていない個所もあります)。仮想マシンおよび MIDP の実装のために使用することは避けてください。そのような用途には必ず公式仕様書原文そのものを用いるべきです。
この API リファレンスに記載されている内容は"さかきけい"が Sun Microsystems, Inc や Motorola, Inc、Java Community Process が公開している各種公式資料を元に、独自に調査・編集したものであり、Sun Microsystems, Inc や Motorola, Inc、Java Community Process 等とは一切関係ありません。したがってこの API リファレンスに関する問い合わせを関係各社等に対して行うことを固く禁じます。
また、記載された内容には既知か否かに関らず誤りが含まれる可能性があり、一切保証はありません。本 API リファレンスを使用した結果、不利益が生じたとしても"さかきけい"は一切の責任を負いません。
許可無く公開/非公開および Internet/Intranet/LAN を問わず他サイトに転載すること、複写および複製すること、ローカル・ファイル等に保存することを禁じます。


Copyright© 2001-2002,2005-2009,2011 by KEI SAKAKI.
ALL RIGHTS RESERVED.
無断転載を禁じます。

Unofficial "CLDC 1.0 + MIDP 1.0" API Reference はこちらです。