compact1, compact2, compact3

java.io

Class Writer

java.lang.Object

java.io.Writer

All Implemented Interfaces:

Closeable， Flushable， Appendable， AutoCloseable

已知直接子类：

BufferedWriter， CharArrayWriter， FilterWriter， OutputStreamWriter， PipedWriter， PrintWriter， StringWriter

public abstract class Writer
extends Object
implements Appendable, Closeable, Flushable

用于写入到字符流的抽象类。这一类必须实现的唯一方法是写（char []，int，int），flush()，和（）。大多数子类，但是，将重写这里定义的一些方法，以提供更高的效率，额外的功能，或两者都有。

从以下版本开始：

JDK1.1

另请参见：

Writer， BufferedWriter， CharArrayWriter， FilterWriter， OutputStreamWriter， FileWriter， PipedWriter， PrintWriter， StringWriter， Reader

Field Summary

Fields

Modifier and Type	Field and Description
protected Object	lock 用于在该流上同步操作的对象。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Writer() 创建一个新的字符流的作者，其关键部分将同步在“作者”本身上。
protected	Writer(Object lock) 创建一个新的字符流的作者，其关键部分将在给定的对象上同步。

方法摘要

Modifier and Type	Method and Description
Writer	append(char c) 将指定的字符到这个作家。
Writer	append(CharSequence csq) 将指定的字符序列，这个作家。
Writer	append(CharSequence csq, int start, int end) 添加一个序列指定的字符序列，这个作家。
abstract void	close() 关闭流，冲洗它。
abstract void	flush() 冲流。
void	write(char[] cbuf) 写一个字符数组。
abstract void	write(char[] cbuf, int off, int len) 写入一个字符数组的一部分。
void	write(int c) 写一个字符。
void	write(String str) 写一个字符串。
void	write(String str, int off, int len) 写入字符串的一部分。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

lock

protected Object lock

用于在该流上同步操作的对象。为了效率，一个字符流对象可以使用一个对象以外的其他来保护关键部分。子类必须使用对象在这场而不是 this或同步方法。

Constructor Detail

Writer

protected Writer()

创建一个新的字符流的作者，其关键部分将同步在“作者”本身上。

Writer

protected Writer(Object lock)

创建一个新的字符流的作者，其关键部分将在给定的对象上同步。

参数

lock对象来同步

方法详细信息

write

public void write(int c)
           throws IOException

写一个字符。要写入的字符包含在给定的整数值的16个低阶位中，16个高阶位被忽略。

打算支持高效的单字符输出的子类应重写此方法。

参数

c - int指定要写入的字符

异常

IOException如果I/O错误发生

write

public void write(char[] cbuf)
           throws IOException

写一个字符数组。

参数

cbuf -要写入的字符数组

异常

IOException如果I/O错误发生

write

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

写入一个字符数组的一部分。

参数

cbuf -字符数组

偏移量从 off -开始写作的特点

len数字写

异常

IOException如果I/O错误发生

write

public void write(String str)
           throws IOException

写一个字符串。

参数

str字符串被写入

异常

IOException如果I/O错误发生

write

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

写入字符串的一部分。

参数

str -一个字符串

off偏移从开始写汉字

写 len -字符数

异常

IndexOutOfBoundsException -如果 off是负的，或 len是负的，或 off+len阴性或大于给定的字符串的长度

IOException如果I/O错误发生

append

public Writer append(CharSequence csq)
              throws IOException

将指定的字符序列，这个作家。

这种形式的out.append(csq)方法调用的行为一样，调用

写出来。（CSQ。tostring()）

根据字符序列的csq toString规范，整个序列可能不追加。例如，调用字符缓冲区的toString方法将返回一个序列的内容取决于缓冲区的位置和范围。

Specified by:

append 接口 Appendable

参数

csq -字符序列添加。如果 csq是 null，然后四个字 "null"附加到这个作家。

结果

这个作家

异常

IOException如果I/O错误发生

从以下版本开始：

一点五

append

public Writer append(CharSequence csq,
                     int start,
                     int end)
              throws IOException

添加一个序列指定的字符序列，这个作家。 Appendable。

这种形式的out.append(csq, start, end)方法调用时，csq不null表现在完全相同的方式调用

写出来。（CSQ。子序列（开始、结束）。tostring()）

Specified by:

append 接口 Appendable

参数

csq -字符序列的子序列将追加。如果 csq是 null，那么人物将追加好像 csq包含四个字符 "null"。

start -子序列中的第一个字符的索引

end -子序列中的最后一个字符后的字符的索引

结果

这个作家

异常

IndexOutOfBoundsException -如果 start或 end是负面的， start大于 end，或 end大于 csq.length()

IOException如果I/O错误发生

从以下版本开始：

一点五

append

public Writer append(char c)
              throws IOException

将指定的字符到这个作家。

这种形式的out.append(c)方法调用的行为一样，调用

外写（c）

Specified by:

append 接口 Appendable

参数

c - 16位字符追加

结果

这个作家

异常

IOException如果I/O错误发生

从以下版本开始：

一点五

flush

public abstract void flush()
                    throws IOException

冲流。如果流在缓冲区的各种write()方法保存的任何字符，立即向其目的地写。然后，如果该目的地是另一个字符或字节流，刷新它。因此，一个flush()调用将冲洗链中的作家和OutputStreams所有缓冲区。

如果此流的预期目的地是底层操作系统提供的一个抽象，例如一个文件，然后刷新流只保证以前写入流的字节被传递给操作系统，它不保证它们实际上被写入到一个物理设备，如磁盘驱动器。

Specified by:

flush 接口 Flushable

异常

IOException如果I/O错误发生

close

public abstract void close()
                    throws IOException

关闭流，冲洗它。一旦流已经关闭，进一步write()或flush()调用将导致资源被。关闭先前关闭的流没有影响。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

异常

IOException如果I/O错误发生