java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

java.io
类 StringWriter

java.lang.Object
  继承者 java.io.Writer
      继承者 java.io.StringWriter
所有已实现的接口:
Closeable, Flushable, Appendable

public class StringWriter
extends Writer

一个字符流,可以用其回收在字符串缓冲区中的输出来构造字符串。

关闭 StringWriter 无效。在关闭此流后且没有生成 IOException 时,可以调用此类中的该方法。

从以下版本开始:
JDK1.1

字段摘要
 
从类 java.io.Writer 继承的字段
lock
 
构造方法摘要
StringWriter()
          创建具有默认初始字符串缓冲区大小的新字符串 writer。
StringWriter(int initialSize)
          创建具有指定初始字符串缓冲区大小的新字符串 writer。
 
方法摘要
 StringWriter append(char c)
          将指定字符追加到此 writer。
 StringWriter append(CharSequence csq)
          将指定的字符序列追加到此 writer。
 StringWriter append(CharSequence csq, int start, int end)
          将指定字符序列的子序列追加到此 writer。
 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)
          写入字符串的某一部分。
 
从类 java.io.Writer 继承的方法
write
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

StringWriter

public StringWriter()
创建具有默认初始字符串缓冲区大小的新字符串 writer。


StringWriter

public StringWriter(int initialSize)
创建具有指定初始字符串缓冲区大小的新字符串 writer。

参数:
initialSize - 一个指定缓冲区初始大小的 int。
方法详细信息

write

public void write(int c)
写入单个字符。

覆盖:
Writer 中的 write
参数:
c - 指定要写入字符的 int。

write

public void write(char[] cbuf,
                  int off,
                  int len)
写入字符数组的某一部分。

指定者:
Writer 中的 write
参数:
cbuf - 字符数组
off - 开始写入字符处的偏移量
len - 要写入的字符数

write

public void write(String str)
写入一个字符串。

覆盖:
Writer 中的 write
参数:
str - 要写入的字符串

write

public void write(String str,
                  int off,
                  int len)
写入字符串的某一部分。

覆盖:
Writer 中的 write
参数:
str - 要写入的字符串
off - 开始写入字符处的偏移量
len - 要写入的字符数

append

public StringWriter append(CharSequence csq)
将指定的字符序列追加到此 writer。

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

     out.write(csq.toString()) 

可能没有追加整个序列,这取决于对字符序列 csqtoString 指定。例如,调用一个字符缓冲区的 toString 方法将返回一个子序列,其内容取决于缓冲区的位置和限制。

指定者:
接口 Appendable 中的 append
覆盖:
Writer 中的 append
参数:
csq - 要追加的字符串序列。如果 csqnull,则向此 writer 追加四个字符 "null"
返回:
此 writer
从以下版本开始:
1.5

append

public StringWriter append(CharSequence csq,
                           int start,
                           int end)
将指定字符序列的子序列追加到此 writer。

csq 不为 null 时,调用该方法的 out.append(csq、 start、 end) 形式,行为与以下调用完全相同:

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

指定者:
接口 Appendable 中的 append
覆盖:
Writer 中的 append
参数:
csq - 子序列将被追加的字符序列。如果 csqnull,则追加四个字符 "null",就好像 csq 包含它们一样。
start - 子序列中第一个字符的索引
end - 子序列中最后一个字符后面的字符的索引
返回:
此 writer
抛出:
IndexOutOfBoundsException - 如果 startend 为负,而 start 大于 end 或者 end 大于 csq.length()
从以下版本开始:
1.5

append

public StringWriter append(char c)
将指定字符追加到此 writer。

out.append(c) 的形式调用此方法,行为与以下调用完全相同:

     out.write(c) 

指定者:
接口 Appendable 中的 append
覆盖:
Writer 中的 append
参数:
c - 要追加的 16 位字符
返回:
此 writer
从以下版本开始:
1.5

toString

public String toString()
以字符串的形式返回该缓冲区的当前值。

覆盖:
Object 中的 toString
返回:
该对象的字符串表示形式。

getBuffer

public StringBuffer getBuffer()
返回该字符串缓冲区本身。

返回:
保存当前缓冲区值的 StringBuffer。

flush

public void flush()
刷新该流的缓冲。

指定者:
接口 Flushable 中的 flush
指定者:
Writer 中的 flush

close

public void close()
           throws IOException
关闭 StringWriter 无效。在关闭此流后且没有生成 IOException 时,可以调用此类中的该方法。

指定者:
接口 Closeable 中的 close
指定者:
Writer 中的 close
抛出:
IOException - 如果发生 I/O 错误

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策