StringWriter

StringWriter

java.io

---

Java 1.1

appendable closeable flushable

This class is a character output stream that uses an internal StringBuffer object as the destination of the characters written to the stream. When you create a StringWriter , you may optionally specify an initial size for the StringBuffer , but you do not specify the StringBuffer itself; it is managed internally by the StringWriter and grows as necessary to accommodate the characters written to it. StringWriter defines the standard write( ) , flush( ) , and close( ) methods all Writer subclasses define, as well as two methods to obtain the characters that have been written to the stream's internal buffer. toString( ) returns the contents of the internal buffer as a String , and getBuffer( ) returns the buffer itself. Note that getBuffer( ) returns a reference to the actual internal buffer, not a copy of it, so any changes you make to the buffer are reflected in subsequent calls to toString( ) . StringWriter is quite similar to CharArrayWriter , but does not have a byte-stream analog.

Figure 9-60. java.io.StringWriter

 public class  StringWriter  extends Writer {  // Public Constructors  public  StringWriter  ( );        public  StringWriter  (int  initialSize  );  // Public Instance Methods   5.0  public StringWriter  append  (CharSequence  csq  );  5.0  public StringWriter  append  (char  c  );  5.0  public StringWriter  append  (CharSequence  csq  , int  start  , int  end  );        public StringBuffer  getBuffer  ( );  // Public Methods Overriding Writer  public void  close  ( ) throws IOException;  empty  public void  flush  ( );  empty  public void  write  (int  c  );        public void  write  (String  str  );        public void  write  (String  str  , int  off  , int  len  );        public void  write  (char[ ]  cbuf  , int  off  , int  len  );  // Public Methods Overriding Object  public String  toString  ( );   }