java.io

クラス BufferedOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.BufferedOutputStream

すべての実装されたインタフェース:

Closeable、Flushable、AutoCloseable

public class BufferedOutputStream
extends FilterOutputStream

バッファリングされた出力ストリームを実装します。このような出力ストリームを設定することにより、アプリケーションは、バイト単位でベースとなるシステムを呼び出さなくても、複数のバイトをベースとなる出力ストリームに書き込むことができます。

導入されたバージョン:

JDK1.0

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected byte[]	buf データが格納される内部バッファーです。
protected int	count バッファーの中の有効バイト数です。

クラス java.io.FilterOutputStream から継承されたフィールド

out

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
BufferedOutputStream(OutputStream out) 指定されたベースとなる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを作成します。
BufferedOutputStream(OutputStream out, int size) 指定されたベースとなる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを、指定されたバッファーサイズで作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	flush() バッファリングされた出力ストリームをフラッシュします。
void	write(byte[] b, int off, int len) 指定されたバイト配列のオフセット位置 off から始まる len バイトをこのバッファリングされた出力ストリームに書き込みます。
void	write(int b) 指定されたバイト数をバッファリングされた出力ストリームに書き込みます。

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

close, write

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

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

フィールドの詳細

buf

protected byte[] buf

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

count

protected int count

バッファーの中の有効バイト数です。この値の範囲は、常に 0 から buf.length です。有効なバイトデータは buf[0] から buf[count-1] の要素に格納されます。

コンストラクタの詳細

BufferedOutputStream

public BufferedOutputStream(OutputStream out)

指定されたベースとなる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを作成します。

パラメータ:

out - ベースとなる出力ストリーム。

BufferedOutputStream

public BufferedOutputStream(OutputStream out,
                    int size)

指定されたベースとなる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを、指定されたバッファーサイズで作成します。

パラメータ:

out - ベースとなる出力ストリーム。

size - バッファーサイズ。

例外:

IllegalArgumentException - size が 0 以下の場合。

メソッドの詳細

write

public void write(int b)
           throws IOException

指定されたバイト数をバッファリングされた出力ストリームに書き込みます。

オーバーライド:

write、クラス: FilterOutputStream

パラメータ:

b - 書き込まれるバイト。

例外:

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

write

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

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

このメソッドは通常、指定された配列からこのストリームのバッファーへバイトを格納し、必要に応じてベースとなる出力ストリームにバッファーをフラッシュします。しかし、要求された長さがこのストリームのバッファーと同じ大きさ以上の場合、このメソッドはバッファーをフラッシュし、そのバイトをベースとなる出力ストリームに直接書き込みます。このため、余分な BufferedOutputStream がデータを不必要にコピーすることがありません。

オーバーライド:

write、クラス: FilterOutputStream

パラメータ:

b - データ。

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

len - 書き込むバイト数。

例外:

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

関連項目:

FilterOutputStream.write(int)

flush

public void flush()
           throws IOException

バッファリングされた出力ストリームをフラッシュします。この処理により、バッファリングされているすべての出力バイトがベースとなる出力ストリームに書き込まれます。

定義:

flush、インタフェース: Flushable

オーバーライド:

flush、クラス: FilterOutputStream

例外:

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

関連項目:

FilterOutputStream.out