JavaTM 2 Platform
Std. Ed. v1.3

java.io
クラス BufferedOutputStream

java.lang.Object
  |
  +--java.io.OutputStream
        |
        +--java.io.FilterOutputStream
              |
              +--java.io.BufferedOutputStream

public class BufferedOutputStream
extends FilterOutputStream

バッファリングされた出力ストリームを実装します。このような出力ストリームを設定することにより、アプリケーションは、バイト単位で基本となるシステムを呼び出さなくても、複数のバイトを基本となるストリームに書き込むことができます。データは内部バッファに書き込まれます。次に、バッファがその容量の限界に達した場合や、バッファ出力ストリームが閉じられたり明示的にフラッシュされた場合には、基本となるストリームに書き込まれます。

導入されたバージョン:
JDK1.0

フィールドの概要
protected  byte[] buf
          データが格納される内部バッファです。
protected  int count
          バッファ内に存在する有効バイト数です。
 
クラス java.io.FilterOutputStream から継承したフィールド
out
 
コンストラクタの概要
BufferedOutputStream(OutputStream out)
          指定された基本となる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを、デフォルトのバッファサイズ 512 バイトで作成します。
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
バッファ内に存在する有効バイト数です。この値の範囲は、常に 0buf.length です。有効なバイトデータは buf[0]buf[count-1] の要素に格納されます。
コンストラクタの詳細

BufferedOutputStream

public BufferedOutputStream(OutputStream out)
指定された基本となる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを、デフォルトのバッファサイズ 512 バイトで作成します。
パラメータ:
out - 基本となる出力ストリーム

BufferedOutputStream

public BufferedOutputStream(OutputStream out,
                            int size)
指定された基本となる出力ストリームにデータを書き込むためのバッファリングされた出力ストリームを、指定されたバッファサイズで作成します。
パラメータ:
out - 基本となる出力ストリーム
size - バッファサイズ
例外:
IllegalArgumentException - size が 0 以下の場合
メソッドの詳細

write

public void write(int b)
           throws IOException
指定されたバイト数をバッファリングされた出力ストリームに書き込みます。
オーバーライド:
クラス FilterOutputStream 内の write
パラメータ:
b - 書き込まれるバイト
例外:
IOException - 入出力エラーが発生した場合

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
指定されたバイト配列のオフセット off から始まる len バイトを、バッファリングされた出力ストリームに書き込みます。

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

オーバーライド:
クラス FilterOutputStream 内の write
パラメータ:
b - データ
off - データの開始オフセット
len - 書き込むバイト数
例外:
IOException - 入出力エラーが発生した場合

flush

public void flush()
           throws IOException
バッファリングされた出力ストリームをフラッシュします。この処理により、バッファの内容はすべて基本となる出力ストリームに書き込まれます。
オーバーライド:
クラス FilterOutputStream 内の flush
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.