java.io
クラス ByteArrayOutputStream

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

public class ByteArrayOutputStream
extends OutputStream

データがバイト配列に書き込まれる出力ストリームを実装します。データが書き込まれるに従って、バッファーは自動的に大きくなります。toByteArray() と toString() を使ってデータを取り出すことができます。

ByteArrayOutputStream を閉じても、何の影響もありません。IOException を生成せずにストリームが閉じられたあとで、このクラスのメソッドを呼び出すことができます。

導入されたバージョン:

JDK1.0

フィールドの概要

protected byte[]	buf データが格納されるバッファーです。
protected int	count バッファーの中の有効バイト数です。

コンストラクタの概要

ByteArrayOutputStream()
バイト配列出力ストリームを新しく作成します。

ByteArrayOutputStream(int size)
バイト数で指定されたサイズのバッファーを持つ、バイト配列出力ストリームを新しく作成します。

メソッドの概要

void	close() ByteArrayOutputStream を閉じても、何の影響もありません。
void	reset() バイト配列出力ストリームの count フィールドをゼロにリセットします。
int	size() バッファーの現在のサイズを返します。
byte[]	toByteArray() メモリーを割り当ててバイト配列を新しく作成します。
String	toString() プラットフォームのデフォルトの文字エンコーディングに従ってバイトを文字に変換しながら、バッファーの内容を文字列に変換します。
String	toString(String enc) 指定された文字エンコーディングに従ってバイトを文字に変換しながら、バッファーの内容を文字列に変換します。
void	write(byte[] b, int off, int len) 指定されたバイト配列のオフセット位置 off から始まる len バイトを、バイト配列出力ストリームに書き込みます。
void	write(int b) 指定されたバイトを、バイト配列出力ストリームに書き込みます。
void	writeTo(OutputStream out) バイト配列出力ストリームのすべての内容を、指定された出力ストリーム引数に書き込みます。

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

flush, write

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

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

フィールドの詳細

buf

protected byte[] buf

データが格納されるバッファーです。

count

protected int count

バッファーの中の有効バイト数です。

コンストラクタの詳細

ByteArrayOutputStream

public ByteArrayOutputStream()

バイト配列出力ストリームを新しく作成します。バッファー容量の初期値は 32 バイトですが、このサイズは必要に応じて大きくなります。

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

バイト数で指定されたサイズのバッファーを持つ、バイト配列出力ストリームを新しく作成します。

パラメータ:

size - 初期サイズ

例外:

IllegalArgumentException - サイズが負の値の場合

メソッドの詳細

write

public void write(int b)

指定されたバイトを、バイト配列出力ストリームに書き込みます。

定義:

クラス OutputStream 内の write

パラメータ:

b - 書き込むバイト

write

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

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

オーバーライド:

クラス OutputStream 内の write

パラメータ:

b - データ

off - データの開始オフセット

len - 書き込むバイト数

writeTo

public void writeTo(OutputStream out)
             throws IOException

バイト配列出力ストリームのすべての内容を、指定された出力ストリーム引数に書き込みます。これは out.write(buf, 0, count) を使って出力ストリームの write メソッドを呼び出すのと同じです。

パラメータ:

out - データを書き込む出力ストリーム

例外:

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

reset

public void reset()

バイト配列出力ストリームの count フィールドをゼロにリセットします。この結果、現在出力ストリームに蓄積されているすべてのデータは廃棄されます。この出力ストリームは、すでに割り当てられているバッファースペースを使って、再度使用することができます。

関連項目:

ByteArrayInputStream.count

toByteArray

public byte[] toByteArray()

メモリーを割り当ててバイト配列を新しく作成します。配列のサイズは現在の出力ストリームと同じで、バッファーの中の有効データはここにコピーされます。

戻り値:

出力ストリームの現在の内容をバイト配列として返す

関連項目:

size()

size

public int size()

バッファーの現在のサイズを返します。

戻り値:

count フィールドの値。出力ストリームの中の有効バイト数を表す

関連項目:

count

toString

public String toString()

プラットフォームのデフォルトの文字エンコーディングに従ってバイトを文字に変換しながら、バッファーの内容を文字列に変換します。

オーバーライド:

クラス Object 内の toString

戻り値:

バッファーの内容から変換された文字列

導入されたバージョン:

JDK1.1

toString

public String toString(String enc)
                throws UnsupportedEncodingException

指定された文字エンコーディングに従ってバイトを文字に変換しながら、バッファーの内容を文字列に変換します。

パラメータ:

enc - 文字エンコーディングの名前

戻り値:

バッファーの内容から変換された文字列

例外:

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

導入されたバージョン:

JDK1.1

close

public void close()
           throws IOException

ByteArrayOutputStream を閉じても、何の影響もありません。IOException を生成せずにストリームが閉じられたあとで、このクラスのメソッドを呼び出すことができます。

オーバーライド:

クラス OutputStream 内の close

例外:

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