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

用于写入字符流的抽象类。 子类必须实现的唯一方法是write（char []，int，int），flush（）和close（）。 然而，大多数子类将覆盖这里定义的一些方法，以便提供更高的效率，附加的功能或两者。

从以下版本开始：

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

字段详细信息

lock

protected Object lock

用于同步此流上的操作的对象。 为了效率，字符流对象可以使用自身以外的对象来保护关键部分。 因此，子类应该使用此字段中的对象而不是this或同步方法。

构造方法详细信息

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 - cbuf数组

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

len - 要写入的 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 - 要写入的 len数

异常

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

IOException - 如果发生I / O错误

append

public Writer append(CharSequence csq)
              throws IOException

将指定的字符序列附加到此作者。

调用此方法的形式out.append(csq)的行为方式与调用完全相同

  out.write(csq.toString()) 

取决于toString字符序列csq本说明书中，整个序列可以不追加。 例如，调用字符缓冲区的toString方法将返回一个子序列，其内容取决于缓冲区的位置和限制。

Specified by:

append在界面 Appendable

参数

csq - 要追加的字符序列。 如果csq是null ，那么四个字符"null"被附加到该写入器。

结果

这位作家

异常

IOException - 如果发生I / O错误

从以下版本开始：

1.5

append

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

将指定字符序列的子序列附加到此作者。 Appendable 。

形式的这种方法的调用时out.append(csq, start, end) csq是完全相同的方式调用不null的行为

  out.write(csq.subSequence(start, end).toString()) 

Specified by:

append在界面 Appendable

参数

csq - 追加子序列的字符序列。 如果csq是null ，则会附加字符 ，如果csq包含四个字符"null" 。

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

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

结果

这位作家

异常

IndexOutOfBoundsException - 如果 start或 end为负数，则 start大于 end ，或 end大于 csq.length()

IOException - 如果发生I / O错误

从以下版本开始：

1.5

append

public Writer append(char c)
              throws IOException

将指定的字符附加到此作者。

对这种形式out.append(c)的这种方法的调用与调用的方式完全相同

  out.write(c) 

Specified by:

append在界面 Appendable

参数

c - 要追加的16位字符

结果

这位作家

异常

IOException - 如果发生I / O错误

从以下版本开始：

1.5

flush

public abstract void flush()
                    throws IOException

刷新流。 如果流已经从缓冲区中的各种write（）方法保存了任何字符，请将它们立即写入到其预期目的地。 然后，如果该目的地是另一个字符或字节流，请将其刷新。 因此，一个flush（）调用将刷新Writers和OutputStreams链中的所有缓冲区。

如果此流的预期目标是由底层操作系统（例如文件）提供的抽象，那么刷新流仅保证先前写入流的字节传递到操作系统进行写入; 它并不保证它们实际上被写入物理设备，如磁盘驱动器。

Specified by:

flush在界面 Flushable

异常

IOException - 如果发生I / O错误

close

public abstract void close()
                    throws IOException

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

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

异常

IOException - 如果发生I / O错误