java.io
クラス ByteArrayOutputStream

java.lang.Object
  java.io.OutputStream
      java.io.ByteArrayOutputStream

public class ByteArrayOutputStream
extends OutputStream

自動的に拡張されるバイト配列として使用できる出力ストリーム機能を提供するクラスです。 出力ストリーム共通の書き込みによって、byte 配列 buf にデータが蓄積されます。 buf の容量が不足する場合、自動的に容量の拡張を行います。

蓄積したデータは toByteArray() メソッドあるいは toString() メソッドで取り出します。

導入されたバージョン:

CLDC 1.0

buf

protected byte[] buf

書き込まれたデータを保持しています。

count

protected int count

buf のうち、データが書き込み済みのバイト数を保持しています。

ByteArrayOutputStream

public ByteArrayOutputStream()

バッファの初期サイズが 32 バイトのオブジェクトを構築します。

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

指定された初期サイズのバッファを持つオブジェクトを構築します。

パラメータ:

size - バッファの初期サイズを渡します。

write

public void write(int data)

渡されたデータを１バイトのデータとしてバッファへ書き込みます。

定義:

クラス OutputStream 内の write

パラメータ:

data - 書き込むデータを渡します。

write

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

渡された byte 配列の指定位置から指定された長さのデータをバッファへ書き込みます。

オーバーライド:

クラス OutputStream 内の write

パラメータ:

data - 書き込むデータを byte 配列で渡します。

index - 書き込むデータの byte 配列内の開始位置を渡します。

length - 書き込むデータの長さを渡します。

reset

public void reset()

count を 0 にし、書き込まれたデータを全て破棄します。 ただし、バッファのサイズ変更や開放は行いません。 このメソッドを呼び出したあとの書き込みは再度先頭からの書き込みとなります。

toByteArray

public byte[] toByteArray()

バッファに書き込まれたデータをコピーした新たな byte 配列を生成して返します。

戻り値:

書き込まれたデータがコピーされた新たな byte 配列を返します。

size

public int size()

バッファに書き込まれたデータのサイズを返します。 この値はバッファのサイズとは必ずしも等価ではありません。

戻り値:

バッファに書き込まれたデータのサイズを返します。

関連項目:

count

toString

public String toString()

バッファに書き込まれたデータをデフォルトの文字エンコーディングにしたがって文字列に変換し、その結果を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

文字列に変換されたデータを返します。

導入されたバージョン:

CLDC 1.0.2

close

public void close()
           throws IOException

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

オーバーライド:

クラス OutputStream 内の close

例外:

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