OutputStreamWriter (Connected Device Configuration (CDC), バージョン 1.1.2)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

CDC 1.1.2

前のクラス 次のクラス

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

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

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

java.io
クラス OutputStreamWriter

java.lang.Object
  java.io.Writer
      java.io.OutputStreamWriter

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

public class OutputStreamWriter
extends Writer
extends Writer

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

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

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

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

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

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

導入されたバージョン:: 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`

コンストラクタの詳細