java.io
クラス ByteArrayOutputStream

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

public class ByteArrayOutputStream
extends OutputStream

ByteArrayOutputStream はバイト配列に出力する出力ストリームです。 バイトデータを書き込む内部のバッファは、データが書き込まれるに従い自動的に拡張されます。 書き込まれたデータは toByteArray または toString で取り出せます。

ByteArrayOutputStream をクローズしても何も影響を及ぼしません。 クローズした後にこのクラスのメソッドを呼び出しても IOException をスローしません。

コンストラクタの概要

ByteArrayOutputStream()
ByteArrayOutputStream を生成します。

ByteArrayOutputStream(int initsize)
指定されたサイズのバッファを持つ ByteArrayOutputStream を生成します。

メソッドの概要

void	close() ByteArrayOutputStream のクローズは何も影響を与えません。
void	reset() バッファされているデータを破棄します。
int	size() 現在バッファに格納されているバイトデータのサイズ（バイト）を返します。
byte[]	toByteArray() 現在までに書き込まれたバイトデータを保持するバイト配列を生成して返します。
String	toString() Modified UTF-8 でバッファのコンテントを解釈した結果の String を返します。
void	write(byte[] b, int off, int len) 指定されたバイト配列 b の、オフセット off から始まる len バイトのデータをこのストリームに書き込みます。
void	write(int b) 指定された1バイトを出力ストリームに書き込みます。

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

flush, write

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

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

コンストラクタの詳細

ByteArrayOutputStream

public ByteArrayOutputStream()

ByteArrayOutputStream を生成します。

ByteArrayOutputStream

public ByteArrayOutputStream(int initsize)

指定されたサイズのバッファを持つ ByteArrayOutputStream を生成します。

パラメータ:

initsize - バッファの初期サイズ（バイト）

例外:

IllegalArgumentException - initsize < 0 の場合

メソッドの詳細

write

public void write(int b)

指定された1バイトを出力ストリームに書き込みます。 書き込むバイトは引数 b の最下位8ビットです。 b の上位24ビットは無視されます。

定義:

クラス OutputStream 内の write

パラメータ:

b - 書き込むバイト

write

public void write(byte[] b,
                  int off,
                  int len)

指定されたバイト配列 b の、オフセット off から始まる len バイトのデータをこのストリームに書き込みます。

オーバーライド:

クラス OutputStream 内の write

パラメータ:

b - 出力するデータを保持する配列

off - 配列 b の、出力するデータが格納されているインデックスオフセット

len - 出力するデータのバイト長

toByteArray

public byte[] toByteArray()

現在までに書き込まれたバイトデータを保持するバイト配列を生成して返します。

戻り値:

現在までに書き込まれているデータがコピーされているバイト配列

reset

public void reset()

バッファされているデータを破棄します。 現在のバッファをそのまま利用してこのストリームを再利用できます。

close

public void close()
           throws IOException

ByteArrayOutputStream のクローズは何も影響を与えません。 クローズ後にこのクラスのメソッドを呼び出しても IOException はスローされません。

オーバーライド:

クラス OutputStream 内の close

例外:

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

toString

public String toString()

Modified UTF-8 でバッファのコンテントを解釈した結果の String を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

バッファのコンテントを変換した結果を保持する String

size

public int size()

現在バッファに格納されているバイトデータのサイズ（バイト）を返します。

戻り値:

現在バッファに格納されているバイトデータのサイズ