OutputStreamWriter (Java 2 プラットフォーム SE v1.4.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.io
クラス OutputStreamWriter

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

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

public class OutputStreamWriter
extends Writer

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

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

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

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

「サロゲートペア」は、2 つの char 値によって表される文字で、\uD800 ～ \uDBFF の「上位」サロゲートと \uDC00 ～ \uDFFF の「下位」サロゲートから構成されます。サロゲートペアによって表される文字が指定された文字エンコーディングによって変換できない場合は、文字エンコーディング依存の「代替シーケンス」が出力ストリームに書き込まれます。

対応する下位サロゲートがない上位サロゲート、または対応する上位サロゲートがない下位サロゲートは、「不正なサロゲート要素」と呼ばれます。不正なサロゲート要素を含む文字ストリームは書き込まないでください。不正なサロゲート要素を書き込んだ場合、このクラスのインスタンスの動作は保証されません。

導入されたバージョン:: JDK1.1
関連項目:: BufferedWriter, OutputStream, Charset

フィールドの概要

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

lock

コンストラクタの概要

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

OutputStreamWriter(OutputStream out, Charset cs)
          与えられた文字エンコーディングを使う OutputStreamWriter を作成します。

OutputStreamWriter(OutputStream out, CharsetEncoder enc)
          与えられた文字エンコーディングエンコーダを使う OutputStreamWriter を作成します。

OutputStreamWriter(OutputStream out, String charsetName)
          指定された文字エンコーディングを使う 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

コンストラクタの詳細