compact1, compact2, compact3

java.io

Class OutputStreamWriter

java.lang.Object

java.io.Writer

java.io.OutputStreamWriter

All Implemented Interfaces:

Closeable ， Flushable ， Appendable ， AutoCloseable

已知直接子类：

FileWriter

public class OutputStreamWriter
extends Writer

OutputStreamWriter是字符的桥梁流以字节流：向其写入的字符编码成使用指定的字节charset 。 它使用的字符集可以由名称指定，也可以被明确指定，或者可以接受平台的默认字符集。

每次调用write（）方法都会使编码转换器在给定字符上被调用。 所得到的字节在写入底层输出流之前累积在缓冲区中。 可以指定此缓冲区的大小，但是默认情况下它大部分用于大多数目的。 请注意，传递给write（）方法的字符不会缓冲。

为了最大的效率，请考虑在BufferedWriter中包装一个OutputStreamWriter，以避免频繁的转换器调用。 例如：

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

代理对是由两个char值的序列表示的字符 ：“\ uD800”到“\ uDBFF”范围内的高代理，后跟“\ uDC00”到“\ uDFFF”范围内的低代理。

一个畸形的替代元素是一个高替代品，其后没有高替代品的低替代品或低替代品。

这个类总是用字符集的默认替换序列替换格式不正确的代理元素和不可映射的字符序列 。 当需要对编码过程进行更多控制时，应使用CharsetEncoder类。

从以下版本开始：

JDK1.1

另请参见：

BufferedWriter ， OutputStream ， Charset

Field Summary

Fields inherited from class java.io.Writer

lock

构造方法摘要

构造方法

Constructor and Description
OutputStreamWriter(OutputStream out) 创建一个使用默认字符编码的OutputStreamWriter。
OutputStreamWriter(OutputStream out, Charset cs) 创建一个使用给定字符集的OutputStreamWriter。
OutputStreamWriter(OutputStream out, CharsetEncoder enc) 创建一个使用给定字符集编码器的OutputStreamWriter。
OutputStreamWriter(OutputStream out, String charsetName) 创建一个使用命名字符集的OutputStreamWriter。

方法摘要

Modifier and Type	Method and Description
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) 写一个字符串的一部分。

Methods inherited from class java.io.Writer

append, append, append, write, write

Methods inherited from class 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 - 一个字符集

从以下版本开始：

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 - 如果发生I / O错误

write

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

写入字符数组的一部分。

Specified by:

write在类别 Writer

参数

cbuf - cbuf缓冲区

off - 从中开始编写字符的偏移量

len - 要写入的 len数

异常

IOException - 如果发生I / O错误

write

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

写一个字符串的一部分。

重写：

write在类别 Writer

参数

str - 一个字符串

off - 开始写入字符的偏移量

len - 要写入的 len数

异常

IOException - 如果发生I / O错误

flush

public void flush()
           throws IOException

刷新流。

Specified by:

flush在界面 Flushable

Specified by:

flush在类别 Writer

异常

IOException - 如果发生I / O错误

close

public void close()
           throws IOException

描述从类别： Writer复制

关闭流，先刷新。 一旦流已关闭，进一步的write（）或flush（）调用将导致抛出IOException。 关闭以前关闭的流无效。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

Specified by:

close在类别 Writer

异常

IOException - 如果发生I / O错误