OutputStreamWriter (Java Platform SE 7)

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

すべての実装されたインタフェース:

Closeable、Flushable、Appendable、AutoCloseable

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

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 の「下位」サロゲートで構成されます。
対応する下位サロゲートがない上位サロゲート、または対応する上位サロゲートがない下位サロゲートは、「不正なサロゲート要素」と呼ばれます。
このクラスは、不正なサロゲート要素やマップ不可文字シーケンスを、常に文字セットのデフォルトの代替シーケンスで置き換えます。エンコード処理をより強力に制御する必要がある場合は、CharsetEncoder クラスを使用してください。
導入されたバージョン:

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 から継承されたメソッド
append, append, append, write, write

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - OutputStreamWriter
```
public OutputStreamWriter(OutputStream out,
                  String charsetName)
                   throws UnsupportedEncodingException
```
    指定された文字セットを使う OutputStreamWriter を作成します。
    
    パラメータ:
    out - OutputStream
    charsetName - サポートされている charset の名前
    
    例外:
    
    UnsupportedEncodingException - 指定されたエンコーディングがサポートされていない場合
  - OutputStreamWriter
```
public OutputStreamWriter(OutputStream out)
```
    デフォルトの文字セットを使う OutputStreamWriter を作成します。
    
    パラメータ:
    out - OutputStream
  - OutputStreamWriter
```
public OutputStreamWriter(OutputStream out,
                  Charset cs)
```
    与えられた文字セットを使う OutputStreamWriter を作成します。
    
    パラメータ:
    out - OutputStream
    cs - charset
    導入されたバージョン:
    
    1.4
  - OutputStreamWriter
```
public OutputStreamWriter(OutputStream out,
                  CharsetEncoder enc)
```
    与えられた文字セットエンコーダを使う OutputStreamWriter を作成します。
    
    パラメータ:
    out - OutputStream
    enc - 文字セットエンコーダ
    導入されたバージョン:
    
    1.4
- メソッドの詳細
  - getEncoding
```
public String getEncoding()
```
    このストリームで使用される文字エンコーディングの名前を返します。
    エンコーディングに互換名がある場合は、その名前を返します。互換名がない場合は、エンコーディングの正規名を返します。
    このインスタンスが OutputStreamWriter(OutputStream, String) コンストラクタを使用して作成された場合、返される名前はエンコーディングに対して一意となり、そのコンストラクタに渡された名前とは異なることがあります。ストリームが閉じられた場合、このメソッドは null を返すことがあります。
    
    戻り値:
    このエンコーディングの互換名。ストリームが閉じている場合は null
    関連項目:
    Charset
  - write
```
public void write(int c)
           throws IOException
```
    単一の文字を書き込みます。
    
    オーバーライド:
    
    write、クラス: Writer
    
    パラメータ:
    c - 書き込まれる文字を指定する int
    
    例外:
    
    IOException - 入出力エラーが発生した場合
  - write
```
public void write(char[] cbuf,
         int off,
         int len)
           throws IOException
```
    文字の配列の一部を書き込みます。
    
    定義:
    
    write、クラス: Writer
    
    パラメータ:
    cbuf - 文字のバッファー
    off - 文字の書き込み開始オフセット
    len - 書き込む文字数
    
    例外:
    
    IOException - 入出力エラーが発生した場合
  - write
```
public void write(String str,
         int off,
         int len)
           throws IOException
```
    文字列の一部を書き込みます。
    
    オーバーライド:
    
    write、クラス: Writer
    
    パラメータ:
    str - 文字列
    off - 文字の書き込み開始オフセット
    len - 書き込む文字数
    
    例外:
    
    IOException - 入出力エラーが発生した場合
  - flush
```
public void flush()
           throws IOException
```
    ストリームをフラッシュします。
    
    定義:
    
    flush、インタフェース: Flushable
    
    定義:
    
    flush、クラス: Writer
    
    例外:
    
    IOException - 入出力エラーが発生した場合
  - close
```
public void close()
           throws IOException
```
    次のクラスからコピーされた説明: Writer
    
    ストリームを最初にフラッシュして、閉じます。ストリームが閉じられたあとに write() または flush() を呼び出すと、IOException がスローされます。すでに閉じられているストリームを閉じても、何の影響もありません。
    
    定義:
    
    close、インタフェース: Closeable
    
    定義:
    
    close、インタフェース: AutoCloseable
    
    定義:
    
    close、クラス: Writer
    
    例外:
    
    IOException - 入出力エラーが発生した場合

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス OutputStreamWriter

フィールドのサマリー

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

コンストラクタのサマリー

メソッドのサマリー

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

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

コンストラクタの詳細

OutputStreamWriter

OutputStreamWriter

OutputStreamWriter

OutputStreamWriter

メソッドの詳細

getEncoding

write

write

write

flush

close