JavaTM 2
Platform
Std. Ed. v1.4.0

java.io
クラス Writer

java.lang.Object
  |
  +--java.io.Writer
直系の既知のサブクラス:
BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, PipedWriter, PrintWriter, StringWriter

public abstract class Writer
extends Object

文字ストリームに書き込むための抽象クラスです。サブクラスが実装する必要のあるメソッドは、write(char[], int, int)、flush()、および close() だけです。ただし、ほとんどのサブクラスでは、効率を良くするかまたは機能を追加する (またはその両方) ために、ここで定義するメソッドの一部をオーバーライドします。

導入されたバージョン:
JDK1.1
関連項目:
Writer, BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, FileWriter, PipedWriter, PrintWriter, StringWriter, Reader

フィールドの概要
protected  Object lock
          このストリームで操作を同期させるのに使うオブジェクトです。
 
コンストラクタの概要
protected Writer()
          そのクリティカルセクションがライター自体で同期する、新しい文字ストリームライターを作成します。
protected Writer(Object lock)
          そのクリティカルセクションが指定されたオブジェクトで同期する、新しい文字ストリームライターを作成します。
 
メソッドの概要
abstract  void close()
          ストリームを閉じてフラッシュします。
abstract  void flush()
          ストリームをフラッシュします。
 void write(char[] cbuf)
          文字の配列を書き込みます。
abstract  void write(char[] cbuf, int off, int len)
          文字の配列の一部を書き込みます。
 void write(int c)
          単一文字を書き込みます。
 void write(String str)
          文字列を書き込みます。
 void write(String str, int off, int len)
          文字列の一部を書き込みます。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

lock

protected Object lock
このストリームで操作を同期させるのに使うオブジェクトです。効率を良くするため、文字ストリームオブジェクトでは、ほかのオブジェクトを使ってクリティカルセクションを保護することができます。そのため、サブクラスでは、this や同期メソッドではなく、このフィールドのオブジェクトを使用します。

コンストラクタの詳細

Writer

protected Writer()
そのクリティカルセクションがライター自体で同期する、新しい文字ストリームライターを作成します。


Writer

protected Writer(Object lock)
そのクリティカルセクションが指定されたオブジェクトで同期する、新しい文字ストリームライターを作成します。

パラメータ:
lock - 同期するオブジェクト
メソッドの詳細

write

public void write(int c)
           throws IOException
単一文字を書き込みます。書き込まれる文字は、指定された整数値の下位 16 ビットに格納されます。上位 16 ビットは無視されます。

有効な単一文字の出力をサポートするためのサブクラスでは、このメソッドをオーバーライドします。

パラメータ:
c - 書き込む文字を指定する int
例外:
IOException - 入出力エラーが発生した場合

write

public void write(char[] cbuf)
           throws IOException
文字の配列を書き込みます。

パラメータ:
cbuf - 書き込む文字の配列
例外:
IOException - 入出力エラーが発生した場合

write

public abstract void write(char[] cbuf,
                           int off,
                           int len)
                    throws IOException
文字の配列の一部を書き込みます。

パラメータ:
cbuf - 文字の配列
off - 文字の書き込み開始オフセット
len - 書き込む文字数
例外:
IOException - 入出力エラーが発生した場合

write

public void write(String str)
           throws IOException
文字列を書き込みます。

パラメータ:
str - 書き込まれる文字列
例外:
IOException - 入出力エラーが発生した場合

write

public void write(String str,
                  int off,
                  int len)
           throws IOException
文字列の一部を書き込みます。

パラメータ:
str - 文字列
off - 文字の書き込み開始オフセット
len - 書き込む文字数
例外:
IOException - 入出力エラーが発生した場合

flush

public abstract void flush()
                    throws IOException
ストリームをフラッシュします。ストリームがさまざまな write() メソッドからの文字をバッファに保存してある場合、これらの文字の目的の宛先にただちに文字を書き込みます。宛先が別の文字またはバイトストリームの場合は、この宛先をフラッシュします。つまり 1 つの flush() の呼び出しで、関連する Writer および OutputStream のすべてのバッファをフラッシュします。

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

close

public abstract void close()
                    throws IOException
ストリームを閉じてフラッシュします。ストリームを一度閉じると、以降 write() または flush() を呼び出すと、IOException がスローされます。ただし、前に閉じたストリームを閉じても効果はありません。

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

JavaTM 2
Platform
Std. Ed. v1.4.0

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

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