Class StringWriter

public StringWriter()

This method initializes a new StringWriter to write to a StringBuffer initially sized to a default size of 16 chars.

public StringWriter(int size)

This method initializes a new StringWriter to write to a StringBuffer with the specified initial size.

Parameters:

size - The initial size to make the StringBuffer

public StringWriter append(char c)

Specified by:

append in interface Appendable

Overrides:

append in interface Writer

Since:

1.5

public StringWriter append(CharSequence cs)

Specified by:

append in interface Appendable

Overrides:

append in interface Writer

Since:

1.5

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

Specified by:

append in interface Appendable

Overrides:

append in interface Writer

Since:

1.5

public void close()
            throws IOException

This method closes the stream. The contents of the internal buffer can still be retrieved, but future writes are not guaranteed to work.

Specified by:

close in interface Closeable

Overrides:

close in interface Writer

Throws:

IOException - If an error orrurs.

public void flush()

This method flushes any buffered characters to the underlying output. It does nothing in this class.

Specified by:

flush in interface Flushable

Overrides:

flush in interface Writer

public StringBuffer getBuffer()

This method returns the StringBuffer object that this object is writing to. Note that this is the actual internal buffer, so any operations performed on it will affect this stream object.

Returns:

The StringBuffer object being written to

public String toString()

This method returns the contents of the internal StringBuffer as a String.

Overrides:

toString in interface Object

Returns:

A String representing the chars written to this stream.

public void write(char[] chars,
                  int offset,
                  int len)

This method writes len chars from the specified array starting at index offset in that array to this stream by appending the chars to the end of the internal buffer.

Overrides:

write in interface Writer

Parameters:

chars - The array of chars to write

offset - The index into the array to start writing from

len - The number of chars to write

public void write(int oneChar)

This method writes a single character to the output, storing it in the internal buffer.

Overrides:

write in interface Writer

Parameters:

oneChar - The char to write, passed as an int.

public void write(String str)

This method writes the characters in the specified String to the stream by appending them to the end of the internal buffer.

Overrides:

write in interface Writer

Parameters:

str - The String to write to the stream.

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

This method writes out len characters of the specified String to the stream starting at character position offset into the stream. This is done by appending the characters to the internal buffer.

Overrides:

write in interface Writer

Parameters:

str - The String to write characters from

offset - The character position to start writing from

len - The number of characters to write.