compact1, compact2, compact3

java.io

Class StringWriter

java.lang.Object

java.io.Writer

java.io.StringWriter

All Implemented Interfaces:

Closeable， Flushable， Appendable， AutoCloseable

public class StringWriter
extends Writer

一个字符流，它收集在一个字符串缓冲区的输出，然后可以用来构建一个字符串。

关闭StringWriter没有影响。这个类中的方法可以在流一直没有产生一个IOException闭叫。

从以下版本开始：

JDK1.1

Field Summary

Fields inherited from class java.io.Writer

lock

构造方法摘要

构造方法

Constructor and Description
StringWriter() 使用默认的初始字符串缓冲区大小创建一个新的字符串写作者。
StringWriter(int initialSize) 使用指定的初始字符串缓冲区大小创建一个新的字符串写作者。

方法摘要

Modifier and Type	Method and Description
StringWriter	append(char c) 将指定的字符到这个作家。
StringWriter	append(CharSequence csq) 将指定的字符序列，这个作家。
StringWriter	append(CharSequence csq, int start, int end) 添加一个序列指定的字符序列，这个作家。
void	close() 关闭 StringWriter没有影响。
void	flush() 冲洗流。
StringBuffer	getBuffer() 返回字符串缓冲区本身。
String	toString() 返回缓冲区的当前值作为字符串。
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.io.Writer

write

Methods inherited from class java.lang.Object

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

Constructor Detail

StringWriter

public StringWriter()

使用默认的初始字符串缓冲区大小创建一个新的字符串写作者。

StringWriter

public StringWriter(int initialSize)

使用指定的初始字符串缓冲区大小创建一个新的字符串写作者。

参数

initialSize - char值的个数，将融入这个缓冲区之前，它是自动扩展

异常

IllegalArgumentException -如果 initialSize是负的

方法详细信息

write

public void write(int c)

写一个字符。

重写：

write 方法重写，继承类 Writer

参数

c - int指定要写入的字符

write

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

写一个字符数组的一部分。

Specified by:

write 方法重写，继承类 Writer

参数

cbuf -字符数组

off偏移从开始写汉字

len数字写

write

public void write(String str)

写一个字符串。

重写：

write 方法重写，继承类 Writer

参数

str字符串被写入

write

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

写一个字符串的一部分。

重写：

write 方法重写，继承类 Writer

参数

str字符串被写入

off偏移从开始写汉字

写 len -字符数

append

public StringWriter append(CharSequence csq)

将指定的字符序列，这个作家。

这种形式的out.append(csq)方法调用的行为一样，调用

写出来。（CSQ。tostring()）

根据字符序列的csq toString规范，整个序列可能不追加。例如，调用字符缓冲区的toString方法将返回一个序列的内容取决于缓冲区的位置和范围。

Specified by:

append 接口 Appendable

重写：

append 方法重写，继承类 Writer

参数

csq -字符序列添加。如果 csq是 null，然后四个字 "null"附加到这个作家。

结果

这个作家

从以下版本开始：

一点五

append

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

添加一个序列指定的字符序列，这个作家。

这种形式的out.append(csq, start, end)当csq不null方法调用，表现在完全相同的方式调用

写出来。（CSQ。子序列（开始、结束）。tostring()）

Specified by:

append 接口 Appendable

重写：

append 方法重写，继承类 Writer

参数

csq -字符序列的子序列将追加。如果 csq是 null，那么人物将追加好像 csq包含四个字符 "null"。

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

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

结果

这个作家

异常

IndexOutOfBoundsException -如果 start或 end是负面的， start大于 end，或 end大于 csq.length()

从以下版本开始：

一点五

append

public StringWriter append(char c)

将指定的字符到这个作家。

这种形式的out.append(c)方法调用的行为一样，调用

外写（c）

Specified by:

append 接口 Appendable

重写：

append 方法重写，继承类 Writer

参数

c - 16位字符追加

结果

这个作家

从以下版本开始：

一点五

toString

public String toString()

返回缓冲区的当前值作为字符串。

重写：

toString 方法重写，继承类 Object

结果

对象的字符串表示形式。

getBuffer

public StringBuffer getBuffer()

返回字符串缓冲区本身。

结果

StringBuffer控股目前的缓冲值。

flush

public void flush()

冲洗流。

Specified by:

flush 接口 Flushable

Specified by:

flush 方法重写，继承类 Writer

close

public void close()
           throws IOException

关闭 StringWriter没有影响。这个类中的方法可以在流一直没有产生一个 IOException闭叫。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

Specified by:

close 方法重写，继承类 Writer

异常

IOException如果I/O错误发生