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()方法使编码转换器是在给定的字符调用（S）。将所得的字节在写入到底层输出流之前在缓冲区中积累。这个缓冲区的大小可以指定，但默认情况下，它是足够大的用于大多数目的。注意，传递给write()方法的特点是不缓冲。

为了获得最好的效率，考虑包装outputstreamwriter在BufferedWriter从而避免频繁转换调用。例如:

作家=新BufferedWriter（新outputstreamwriter（系统的））；

一个代理对是字符的序列的两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

Constructor Detail

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                          String charsetName)
                   throws UnsupportedEncodingException

创建一个outputstreamwriter使用指定的字符集。

参数

out - An OutputStream

charsetName -支持的 charset名称

异常

UnsupportedEncodingException -如果指定的编码不支持

OutputStreamWriter

public OutputStreamWriter(OutputStream out)

创建一个outputstreamwriter使用默认的字符编码。

参数

out - An OutputStream

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                          Charset cs)

创建一个outputstreamwriter使用给定的字符集。

参数

out - An OutputStream

cs -字符集

从以下版本开始：

一点四

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                          CharsetEncoder enc)

创建一个outputstreamwriter使用给定的字符集编码。

参数

out - An OutputStream

enc -字符集编码

从以下版本开始：

一点四

方法详细信息

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 - Buffer人物

off偏移从开始写汉字

len数字写

异常

IOException如果I/O错误发生

write

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

写入字符串的一部分。

重写：

write 方法重写，继承类 Writer

参数

str -一个字符串

off偏移从开始写汉字

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()调用将导致资源被。关闭先前关闭的流没有影响。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

Specified by:

close 方法重写，继承类 Writer

异常

IOException如果I/O错误发生