类 java.io.Writer

java.lang.Object
   |
   +----java.io.Writer

public abstract class Writer

extends Object

是以下类的父类：

BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, PipedWriter, PrintWriter, StringWriter

写入字符流的抽象类。父类必须实现的仅有方法为 write(char[], int, int), flush() 和 close()。 但是，为了提供更高的效率或额外的功能或两者，大部分子类将覆盖此处定义的方法中的某些方法。

来自：

JDK1.1

参见：

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

变量索引

lock

用于同步操作当前流的对象。

构造子索引

Writer()

创建一新的字符流书写器，书写器自己负责它的关键部分的同步操作。

Writer(Object)

创建一新的字符流书写器，给定对象负责此书写器的关键部分的同步操作。

方法索引

close()

先刷新然后关闭此流。

flush()

刷新流。

write(char[])

写入一个字符数组。

write(char[], int, int)

部分写入一个字符数组。

write(int)

写入单一字符。

write(String)

写入一串。

write(String, int, int)

写入一串的某部分。

变量

 protected Object lock

用于同步操作此流的对象。 为了实现高效率，字符流对象可使用其它的对象来维护它的关键部分。因此子类应该使用此域内的而不是 this 内的对象，或使用同步方法。

构造子

 protected Writer()

创建一新的字符流书写器，书写器自己负责它的关键部分的同步操作。

 protected Writer(Object lock)

创建一新的字符流书写器，给定对象负责它的关键部分的同步操作。

方法

 public void write(int c) throws IOException

写入单一字符。 写入字符包含在给定整型值的低 16 位中，忽略高 16 位。

支持有效的单字符输出的子类，应该覆盖此方法。

抛出： IOException

如果发生一 I/O 错误。

 public void write(char cbuf[]) throws IOException

写入一个字符数组。

参数：

cbuf - 写入的字符数组

抛出： IOException

如果发生一 I/O 错误。

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

将若干字符写入一个数组中。

参数：

cbuf - 字符数组

off - 开始写字符的串偏移

len - 写入的字符数

抛出： IOException

如果发生一 I/O 错误。

 public void write(String str) throws IOException

写入一串。

参数：

str - 写入串

抛出： IOException

如果发生一 I/O 错误。

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

写入一串的某部分。

参数：

str - 一个串

off - 开始写字符的串偏移

len - 写入的字符数

抛出： IOException

如果发生一 I/O 错误。

 public abstract void flush() throws IOException

刷新流。 如果调用各种 write() 方法后的缓存字符数据保存在此流中，那么立即将这些数据写入它们相应的目的地址。如果目的地址是另一个字符或字节流，则刷新它。因此调用一次 flush()，将刷新 Writers 和 OutputStreams 链中的所有缓存区。

抛出： IOException

如果发生一 I/O 错误。

 public abstract void close() throws IOException

先刷新然后关闭此流。 流关闭后，再调用 write() 或 flush() 方法，将抛出一个 IOException 异常。但是，关闭一个以前曾关闭的流，无异常。

抛出： IOException

如果发生一 I/O 错误。