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

java.io
クラス OutputStream

java.lang.Object
  上位を拡張 java.io.OutputStream
直系の既知のサブクラス:
ByteArrayOutputStream, DataOutputStream, PrintStream

public abstract class OutputStream
extends Object

バイト単位で連続的な出力を行う「出力ストリーム」処理を行うすべてのクラスのスーパークラスです。 このクラスは抽象クラスとして宣言されており、write(int) メソッドをサブクラスで実装する必要があります。

関連項目:
InputStream

コンストラクタの概要
OutputStream()
          デフォルトのコンストラクタです。
 
メソッドの概要
 void close()
          出力ストリームをクローズし、関連するリソースをすべて開放します。
 void flush()
          出力ストリームがバッファリングを行っている場合、そのバッファに格納されているデータを直ちに書き込み先に出力します。
 void write(byte[] data)
          出力ストリームへ指定された byte 配列に格納されたデータを書き込みます。
 void write(byte[] data, int index, int length)
          出力ストリームへ指定バイト数分のデータを指定された byte 配列の指定位置から書き込みます。
abstract  void write(int data)
          出力ストリームへデータを 1 バイト書き込みます。
 
クラス java.lang.Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

OutputStream

public OutputStream()
デフォルトのコンストラクタです。

メソッドの詳細

write

public abstract void write(int data)
                    throws IOException

出力ストリームへデータを 1 バイト書き込みます。 書き込むデータは int 型で指定しますが、実際に書き込まれるのは下位 8 ビットのみです。 残りの上位 24 ビットは処理に影響しません。

このメソッドはデータの書き込みに終了するか例外が throw されるまでブロックします。

サブクラスではこの規約に従ってこのメソッドを実装しなければなりません。

パラメータ:
data - 書き込むデータを渡します。
例外:
IOException - データの書き込み時に何らかの障害が発生した場合に throw します。

write

public void write(byte[] data)
           throws IOException

出力ストリームへ指定された byte 配列に格納されたデータを書き込みます。 このメソッドは data.length が示すデータの書き込みが完了するか、例外が throw されるまでブロックします。

このメソッドで例外が throw されるのは以下の場合です。

これらの例外が throw された場合でも、そこまでに書き込んだデータは取り消されません。

OutputStream クラスにおけるこのメソッドは、write(data, 0, data.length) と記述するのと等価です。

パラメータ:
data - 書き込むデータを格納した byte 配列を渡します。
例外:
IOException - データの書き込み時に何らかの障害が発生した場合に throw します。
NullPointerException - datanull が渡された場合に throw します。

write

public void write(byte[] data,
                  int index,
                  int length)
           throws IOException

出力ストリームへ指定バイト数分のデータを指定された byte 配列の指定位置から書き込みます。 このメソッドは指定バイト数のデータの書き込みが完了するか、例外が throw されるまでブロックします。

このメソッドで例外が throw されるのは以下の場合です。

これらの例外が throw された場合でも、そこまでに書き込んだデータは取り消されません。

OutputStream クラスにおけるこのメソッドは、write(int) メソッドを必要回数呼び出してデータを書き込むように記述されています。

サブクラスでより効率的な処理が可能な場合はオーバーライドして処理を記述すべきです。

パラメータ:
data - 書き込むデータを格納した byte 配列を渡します。
index - 書き込むデータを格納した byte 配列の書き込み開始位置を渡します。
length - 書き込むバイト数を渡します。
例外:
IOException - データの書き込み時に何らかの障害が発生した場合に throw します。
NullPointerException - datanull が渡された場合に throw します。
IndexOutOfBoundsException - index が負数あるいは index + lengthdata のサイズを超える場合に throw します。

flush

public void flush()
           throws IOException

出力ストリームがバッファリングを行っている場合、そのバッファに格納されているデータを直ちに書き込み先に出力します。 サブクラスでバッファリングを伴う実装を行う場合はこのメソッドを適切に実装しなければなりません。

OutputStream クラスにおけるこのメソッドは何も処理を行いません。

例外:
IOException - 処理に伴い、出力関係で何らかの障害が発生した場合に throw します。

close

public void close()
           throws IOException

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

OutputStream クラスにおけるこのメソッドは何も処理を行いません。

例外:
IOException - 処理に伴い、出力関係で何らかの障害が発生した場合に throw します。

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

このAPIリファレンスに記載されている内容は"さかきけい"が Sun Microsystems, Inc や Java Community Process が公開している各種公式資料を元に、独自に調査・編集したものであり、Sun Microsystems, Inc や Java Community Process 等とは一切関係ありません。したがってこのAPIリファレンスに関する問い合わせを関係各社等に対して行うことを固く禁じます。
また、記載された内容には既知か否かに関らず誤りが含まれる可能性があり、一切保証はありません。本APIリファレンスを使用した結果、不利益が生じたとしても"さかきけい"は一切の責任を負いません。
許可無く公開/非公開および Internet/Intranet/LAN を問わず他サイトに転載すること、複写および複製すること、ローカルファイル等に保存することを禁じます。


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

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