java.io
クラス BufferedWriter

java.lang.Object
  |
  +--java.io.Writer
        |
        +--java.io.BufferedWriter

public class BufferedWriter

extends Writer

文字をバッファリングすることによって、文字、配列、または文字列を効率良く文字型出力ストリームに書き込みます。

バッファのサイズは、デフォルト値のままにすることも、特定の値を指定することもできます。デフォルト値は、通常の使い方では十分な大きさです。

行区切り文字はプラットフォームに依存するため、システムの line.separator プロパティで定義される終端記号を書き込む newLine() メソッドが提供されています。すべてのプラットフォームが改行文字 ('¥n') で行を終端させるわけではないので、改行文字を直接書き込むよりも、このメソッドを呼び出して行を終了させることをお勧めします。

一般的に、Writer は、その出力をただちに基礎の文字型ストリームまたはバイトストリームに送信します。プロンプト出力を必要とする場合以外では、FileWriter や OutputStreamWriter のような Writer から直接 write() オペレーションを呼び出すのは効率が悪いので、BufferedWriter でラップすることをお勧めします。たとえば、次の例は PrintWriter のファイルへの出力をバッファリングします。

 PrintWriter out
   = new PrintWriter(new BufferedWriter(new FileWriter("foo.out")));
 

バッファリングしない場合は、print() メソッドを呼び出すたびに文字をバイトに変換してただちにファイルに書き込むので、効率が非常に悪くなります。

導入されたバージョン:

JDK1.1

関連項目:

PrintWriter, FileWriter, OutputStreamWriter

クラス java.io.Writer から継承したフィールド

lock

コンストラクタの概要

BufferedWriter(Writer out)
デフォルトサイズの出力バッファでバッファリングされた、文字型出力ストリームを作成します。

BufferedWriter(Writer out, int sz)
指定されたサイズの出力バッファでバッファリングされた、文字型出力ストリームを新しく作成します。

メソッドの概要

void	close() ストリームを閉じます。
void	flush() ストリームをフラッシュします。
void	newLine() 行区切り文字を書き込みます。
void	write(char[] cbuf, int off, int len) 文字型配列の一部を書き込みます 通常このメソッドは、指定された配列からこのストリームのバッファへ文字を格納し、必要に応じて基礎のストリームにバッファをフラッシュします。
void	write(int c) 単一の文字を書き込みます。
void	write(String s, int off, int len) String の一部を書き込みます。

クラス java.io.Writer から継承したメソッド

write, write

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

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

コンストラクタの詳細

BufferedWriter

public BufferedWriter(Writer out)

デフォルトサイズの出力バッファでバッファリングされた、文字型出力ストリームを作成します。

パラメータ:

out - Writer

BufferedWriter

public BufferedWriter(Writer out,
                      int sz)

指定されたサイズの出力バッファでバッファリングされた、文字型出力ストリームを新しく作成します。

パラメータ:

out - Writer

sz - 出力バッファのサイズ。正の整数

例外:

IllegalArgumentException - sz <= 0 の場合

メソッドの詳細

write

public void write(int c)
           throws IOException

単一の文字を書き込みます。

例外:

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

オーバーライド:

クラス Writer 内の write

write

public void write(char[] cbuf,
                  int off,
                  int len)
           throws IOException

文字型配列の一部を書き込みます

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

パラメータ:

cbuf - 文字型配列

off - 文字の読み込み開始オフセット

len - 書き込む文字数

例外:

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

オーバーライド:

クラス Writer 内の write

write

public void write(String s,
                  int off,
                  int len)
           throws IOException

String の一部を書き込みます。

パラメータ:

s - 書き込む String

off - 文字の読み込み開始オフセット

len - 書き込む文字数

例外:

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

オーバーライド:

クラス Writer 内の write

newLine

public void newLine()
             throws IOException

行区切り文字を書き込みます。行区切り文字は、システムの line.separator プロパティで定義され、単一の改行文字 ('¥n') とは限りません。

例外:

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

flush

public void flush()
           throws IOException

ストリームをフラッシュします。

例外:

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

オーバーライド:

クラス Writer 内の flush

close

public void close()
           throws IOException

ストリームを閉じます。

例外:

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

オーバーライド:

クラス Writer 内の close