Java java.io 类 CharArrayWriter（JDK5）

所有类

java.io
类 CharArrayWriter

java.lang.Object
  java.io.Writer
      java.io.CharArrayWriter

所有已实现的接口：

Closeable, Flushable, Appendable

public class CharArrayWriter
   
   
   
   
   
extends Writer
   
   
   
   
   

此类实现一个可用作 Writer 的字符缓冲区。缓冲区会随向流中写入数据而自动增长。可使用 toCharArray() 和 toString() 检索数据。

注：在此类上调用 close() 无效，并且在关闭该流后可以调用此类中的各个方法，而不会产生任何 IOException。

从以下版本开始：

JDK1.1

buf

protected char[] buf

存储数据的缓冲区。

count

protected int count

缓冲区中的 char 数目。

CharArrayWriter

public CharArrayWriter()

创建一个新的 CharArrayWriter。

CharArrayWriter

public CharArrayWriter(int initialSize)

创建一个具有指定初始大小的新 CharArrayWriter。

参数：

initialSize - 一个指定缓冲区初始大小的 int。

抛出：

IllegalArgumentException - 如果 initialSize 为负。

write

public void write(int c)

将一个字符写入缓冲区。

覆盖：

类 Writer 中的 write

参数：

c - 指定要写入字符的 int。

write

public void write(char[] c,
                  int off,
                  int len)

将字符写入缓冲区。

指定者：

类 Writer 中的 write

参数：

c - 要写入的数据

off - 数据中的起始偏移量

len - 写入的 char 数目

write

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

将字符串的某一部分写入缓冲区。

覆盖：

类 Writer 中的 write

参数：

str - 要写入的字符串

off - 开始读取字符处的偏移量

len - 要写入的字符数

writeTo

public void writeTo(Writer out)
             throws IOException

将缓冲区的内容写入另一个字符流。

参数：

out - 要写入的输出流

抛出：

IOException - 如果发生 I/O 错误。

append

public CharArrayWriter append(CharSequence csq)

将指定的字符序列追加到此 writer。

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

out.write(csq.toString()) 

可能不会追加整个序列，这取决于针对字符序列 csq 的 toString 规范。例如，调用一个字符缓冲区的 toString 方法将返回一个子序列，其内容取决于缓冲区的位置和限制。

指定者：

接口 Appendable 中的 append

覆盖：

类 Writer 中的 append

参数：

csq - 要追加的字符序列。如果 csq 为 null，则向此 writer 追加四个字符 "null"。

返回：

此 writer

从以下版本开始：

1.5