java.io
クラス OutputStreamWriter

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

直系の既知のサブクラス:

FileWriter

public class OutputStreamWriter

extends Writer

OutputStreamWriter は文字ストリームからバイトストリームへの橋渡しの役目を持ち、文字を書き込んで、それを指定された「文字エンコーディング」に従ってバイトに変換します。使用されるエンコーディングは、名前で指定するか、またはプラットフォームのデフォルトをそのまま使うこともできます。

write() メソッドを呼び出すたびに、指定された文字に対してエンコーディングコンバータが呼び出されます。結果として生成されたバイトは、バッファに蓄積されてから基本となる出力ストリームに書き込まれます。このバッファのサイズは指定できますが、ほとんどの場合、デフォルトのサイズで十分です。write() メソッドに渡される文字はバッファに入らないので注意してください。

最大限に効率化するには、コンバータを頻繁に呼び出さないようにするために BufferedWriter の内部に OutputStreamWriter をラップするように考慮してください。次に例を示します

 Writer out
   = new BufferedWriter(new OutputStreamWriter(System.out));
 

導入されたバージョン:

JDK1.1

関連項目:

BufferedWriter, OutputStream, 「文字エンコーディング」

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

lock

コンストラクタの概要

OutputStreamWriter(OutputStream out)
デフォルトの文字エンコーディングを使う OutputStreamWriter を作成します。

OutputStreamWriter(OutputStream out, String enc)
指定された文字エンコーディングを使う OutputStreamWriter を作成します。

メソッドの概要

void	close() ストリームを閉じます。
void	flush() ストリームをフラッシュします。
String	getEncoding() このストリームによって使用されている文字エンコーディングの標準名を返します。
void	write(char[] cbuf, int off, int len) 文字の配列の一部を書き込みます。
void	write(int c) 単一の文字を書き込みます。
void	write(String str, int off, int len) 文字列の一部を書き込みます。

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

write, write

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

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

コンストラクタの詳細

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                          String enc)
                   throws UnsupportedEncodingException

指定された文字エンコーディングを使う OutputStreamWriter を作成します。

パラメータ:

out - OutputStream

enc - サポートされる「文字エンコーディング」 の名前

例外:

UnsupportedEncodingException - 指定された文字エンコーディングがサポートされていない場合

OutputStreamWriter

public OutputStreamWriter(OutputStream out)

デフォルトの文字エンコーディングを使う OutputStreamWriter を作成します。

パラメータ:

out - OutputStream

メソッドの詳細

getEncoding

public String getEncoding()

このストリームによって使用されている文字エンコーディングの標準名を返します。この OutputStreamWriter が OutputStreamWriter(OutputStream, String) コンストラクタで作成された場合、返されるエンコーディング名 (標準名) はコンストラクタに渡されたエンコーディング名と異なることがあります。ストリームが閉じている場合は null が返されることがあります。

戻り値:

エンコーディング名を表す文字列。ストリームが閉じている場合は null

関連項目:

「文字エンコーディング」

write

public void write(int c)
           throws IOException

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

オーバーライド:

クラス Writer 内の write

例外:

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

write

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

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

オーバーライド:

クラス Writer 内の write

パラメータ:

cbuf - 文字のバッファ

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

len - 書き込む文字数

例外:

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

write

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

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

オーバーライド:

クラス Writer 内の write

パラメータ:

str - 文字列

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

len - 書き込む文字数

例外:

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

flush

public void flush()
           throws IOException

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

オーバーライド:

クラス Writer 内の flush

例外:

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

close

public void close()
           throws IOException

ストリームを閉じます。

オーバーライド:

クラス Writer 内の close

例外:

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