CharArrayWriter (Java Platform SE 8 )

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

Class CharArrayWriter

Field Summary

Fields inherited from class java.io.Writer

构造方法摘要

方法摘要

Methods inherited from class java.io.Writer

Methods inherited from class java.lang.Object

字段详细信息

buf

count

构造方法详细信息

CharArrayWriter

CharArrayWriter

方法详细信息

write

write

write

writeTo

append

append

append

reset

toCharArray

size

toString

flush

close