compact1, compact2, compact3

java.io

Class CharArrayWriter

java.lang.Object

java.io.Writer

java.io.CharArrayWriter

All Implemented Interfaces:

Closeable ， Flushable ， Appendable ， AutoCloseable

public class CharArrayWriter
extends Writer

该类实现了可以用作Writer的字符缓冲区。 当数据写入流时，缓冲区会自动增长。 可以使用toCharArray（）和toString（）检索数据。

注意：在此类上调用close（）没有任何效果，并且流已关闭而不生成IOException时可以调用此类的方法。

从以下版本开始：

JDK1.1

Field Summary

Fields

Modifier and Type	Field and Description
protected char[]	buf 存储数据的缓冲区。
protected int	count 缓冲区中的字符数。

Fields inherited from class java.io.Writer

lock

构造方法摘要

构造方法

Constructor and Description
CharArrayWriter() 创建一个新的CharArrayWriter。
CharArrayWriter(int initialSize) 用指定的初始大小创建一个新的CharArrayWriter。

方法摘要

Modifier and Type	Method and Description
CharArrayWriter	append(char c) 将指定的字符附加到此作者。
CharArrayWriter	append(CharSequence csq) 将指定的字符序列附加到此作者。
CharArrayWriter	append(CharSequence csq, int start, int end) 将指定字符序列的子序列附加到此作者。
void	close() 关闭流。
void	flush() 冲洗流。
void	reset() 重置缓冲区，以便您可以再次使用它，而不会丢弃已经分配的缓冲区。
int	size() 返回缓冲区的当前大小。
char[]	toCharArray() 返回输入数据的副本。
String	toString() 将输入数据转换为字符串。
void	write(char[] c, int off, int len) 将字符写入缓冲区。
void	write(int c) 将一个字符写入缓冲区。
void	write(String str, int off, int len) 将一部分字符串写入缓冲区。
void	writeTo(Writer out) 将缓冲区的内容写入另一个字符流。

Methods inherited from class java.io.Writer

write, write

Methods inherited from class java.lang.Object

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

字段详细信息

buf

protected char[] buf

存储数据的缓冲区。

count

protected int count

缓冲区中的字符数。

构造方法详细信息

CharArrayWriter

public CharArrayWriter()

创建一个新的CharArrayWriter。

CharArrayWriter

public CharArrayWriter(int initialSize)

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

参数

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

异常

IllegalArgumentException - 如果initialSize为负

方法详细信息

write

public void write(int c)

将一个字符写入缓冲区。

重写：

write在 Writer

参数

c - int指定要写入的字符

write

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

将字符写入缓冲区。

Specified by:

write在类别 Writer

参数

c - 要写入的数据

off - 数据中的起始偏移量

len - 写入的字符数

write

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

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

重写：

write在 Writer

参数

str - 要写入的字符串

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

len - 要写入的字符数

writeTo

public void writeTo(Writer out)
             throws IOException

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

参数

out - 要写入的输出流

异常

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

append

public CharArrayWriter append(CharSequence csq)

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

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

  out.write(csq.toString()) 

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

Specified by:

append在界面 Appendable

重写：

append在类别 Writer

参数

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

结果

这位作家

从以下版本开始：

1.5

append

public CharArrayWriter append(CharSequence csq,
                              int start,
                              int end)

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

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

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

Specified by:

append在界面 Appendable

重写：

append在 Writer

参数

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

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

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

结果

这位作家

异常

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

从以下版本开始：

1.5

append

public CharArrayWriter append(char c)

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

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

  out.write(c) 

Specified by:

append在界面 Appendable

重写：

append在 Writer

参数

c - 要追加的16位字符

结果

这位作家

从以下版本开始：

1.5

reset

public void reset()

重置缓冲区，以便您可以再次使用它，而不会丢弃已经分配的缓冲区。

toCharArray

public char[] toCharArray()

返回输入数据的副本。

结果

一组从输入数据复制的字符。

size

public int size()

返回缓冲区的当前大小。

结果

一个表示当前缓冲区大小的int。

toString

public String toString()

将输入数据转换为字符串。

重写：

toString在 Object

结果

字符串。

flush

public void flush()

冲洗流。

Specified by:

flush在界面 Flushable

Specified by:

flush在类别 Writer

close

public void close()

关闭流。 此方法不释放缓冲区，因为它的内容可能仍然需要。 注意：在此类中调用此方法将不起作用。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

Specified by:

close在类别 Writer