OutputStreamWriter (Java Platform SE 8)

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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスOutputStreamWriter

フィールドのサマリー

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

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

メソッドのサマリー

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

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

コンストラクタの詳細

OutputStreamWriter

OutputStreamWriter

OutputStreamWriter

OutputStreamWriter

メソッドの詳細

getEncoding

write

write

write

flush

close