public class StringWriter extends Writer
StringBuffer
that
can then be used to retrieve a String
.Constructor and Description |
---|
StringWriter()
This method initializes a new
StringWriter to write to a
StringBuffer initially sized to a default size of 16
chars. |
StringWriter(int size)
This method initializes a new
StringWriter to write to a
StringBuffer with the specified initial size. |
Modifier and Type | Method and Description |
---|---|
StringWriter |
append(char c)
Appends the Unicode character, c, to this
Appendable
object. |
StringWriter |
append(CharSequence cs)
Appends the specified sequence of Unicode characters to this
Appendable object. |
StringWriter |
append(CharSequence cs,
int start,
int end)
Appends the specified subsequence of Unicode characters to this
Appendable object, starting and ending at the specified
positions within the sequence. |
void |
close()
This method closes the stream.
|
void |
flush()
This method flushes any buffered characters to the underlying output.
|
StringBuffer |
getBuffer()
This method returns the
StringBuffer object that this
object is writing to. |
String |
toString()
This method returns the contents of the internal
StringBuffer
as a String . |
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. |
void |
write(int oneChar)
This method writes a single character to the output, storing it in
the internal buffer.
|
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. |
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. |
public StringWriter()
StringWriter
to write to a
StringBuffer
initially sized to a default size of 16
chars.public StringWriter(int size)
StringWriter
to write to a
StringBuffer
with the specified initial size.size
- The initial size to make the StringBuffer
public void close() throws IOException
close
in interface Closeable
close
in class Writer
IOException
- If an error orrurs.public void flush()
public StringBuffer getBuffer()
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.StringBuffer
object being written topublic String toString()
StringBuffer
as a String
.toString
in class Object
String
representing the chars written to
this stream.Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)
public void write(int oneChar)
public void write(char[] chars, int offset, int len)
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.public void write(String str)
String
to the stream by appending them to the end of the internal buffer.public void write(String str, int offset, int len)
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.public StringWriter append(char c)
Appendable
Appendable
object.append
in interface Appendable
append
in class Writer
c
- the character to append.public StringWriter append(CharSequence cs)
Appendable
Appendable
object. The entire sequence may not
be appended, if constrained by the underlying implementation.
For example, a buffer may reach its size limit before the entire
sequence is appended.append
in interface Appendable
append
in class Writer
cs
- the character sequence to append. If seq is null,
then the string "null" (the string representation of null)
is appended.public StringWriter append(CharSequence cs, int start, int end)
Appendable
Appendable
object, starting and ending at the specified
positions within the sequence. The entire sequence may not
be appended, if constrained by the underlying implementation.
For example, a buffer may reach its size limit before the entire
sequence is appended. The behaviour of this method matches the
behaviour of append(seq.subSequence(start,end))
when
the sequence is not null.append
in interface Appendable
append
in class Writer
cs
- the character sequence to append. If seq is null,
then the string "null" (the string representation of null)
is appended.start
- the index of the first Unicode character to use from
the sequence.end
- the index of the last Unicode character to use from the
sequence.