JavaTM 2 Platform
Standard Ed. 5.0

java.io
クラス BufferedOutputStream

java.lang.Object
  上位を拡張 java.io.OutputStream
      上位を拡張 java.io.FilterOutputStream
          上位を拡張 java.io.BufferedOutputStream
すべての実装されたインタフェース:
Closeable, Flushable

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
バッファ内に存在する有効バイト数です。この値の範囲は、常に 0buf.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
指定されたバイト数をバッファリングされた出力ストリームに書き込みます。

オーバーライド:
クラス 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 - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.write(int)

flush

public void flush()
           throws IOException
バッファリングされた出力ストリームをフラッシュします。この処理により、バッファの内容はすべて基本となる出力ストリームに書き込まれます。

定義:
インタフェース Flushable 内の flush
オーバーライド:
クラス FilterOutputStream 内の flush
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。