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

构造方法详细信息

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 - cbuf数组

off - 开始编写字符的偏移量

len - 要写入的 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 - 要写入的 len数

append

public StringWriter 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 StringWriter 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 StringWriter append(char c)

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

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

  out.write(c) 

Specified by:

append在界面 Appendable

重写：

append在类别 Writer

参数

c - 要追加的16位字符

结果

这位作家

从以下版本开始：

1.5

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错误