java.lang.Object | ||
↳ | java.io.Writer | |
↳ | java.io.StringWriter |
A specialized
Writer
that writes characters to a
StringBuffer
in a sequential manner, appending them in the process. The result can later
be queried using the
StringWriter(int)
or
toString()
methods.
[Expand]
Inherited Fields
|
|||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.io.Writer
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Constructs a new
StringWriter
which has a
StringBuffer
allocated with the default size of 16 characters.
|
||||||||||
|
Constructs a new
StringWriter
which has a
StringBuffer
allocated with a size of
initialSize
characters.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Appends the character sequence
csq
to this writer's
StringBuffer
.
|
||||||||||
|
Appends a subsequence of the character sequence
csq
to this
writer's
StringBuffer
.
|
||||||||||
|
Appends the character
c
to this writer's
StringBuffer
.
|
||||||||||
|
Calling this method has no effect.
|
||||||||||
|
Calling this method has no effect.
|
||||||||||
|
Gets a reference to this writer's internal
StringBuffer
.
|
||||||||||
|
Gets a copy of the contents of this writer as a string.
|
||||||||||
|
Writes the characters from the specified string to this writer's
StringBuffer
.
|
||||||||||
|
Writes
count
characters starting at
offset
in
buf
to this writer's
StringBuffer
.
|
||||||||||
|
Writes
count
characters from
str
starting at
offset
to this writer's
StringBuffer
.
|
||||||||||
|
Writes one character to this writer's
StringBuffer
.
|
[Expand]
Inherited Methods
|
|||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.io.Writer
|
|||||||||||
From class
java.lang.Object
|
|||||||||||
From interface
java.io.Closeable
|
|||||||||||
From interface
java.io.Flushable
|
|||||||||||
From interface
java.lang.Appendable
|
|||||||||||
From interface
java.lang.AutoCloseable
|
Constructs a new
StringWriter
which has a
StringBuffer
allocated with the default size of 16 characters. The
StringBuffer
is also the
lock
used to synchronize access to this
writer.
Constructs a new
StringWriter
which has a
StringBuffer
allocated with a size of
initialSize
characters. The
StringBuffer
is also the
lock
used to synchronize access to this
writer.
initialSize | the initial size of the target string buffer. |
---|
Appends the character sequence
csq
to this writer's
StringBuffer
. This method works the same way as
StringWriter.write(csq.toString())
. If
csq
is
null
, then
the string "null" is written to the target stream.
csq | the character sequence appended to the target. |
---|
Appends a subsequence of the character sequence
csq
to this
writer's
StringBuffer
. This method works the same way as
StringWriter.writer(csq.subsequence(start, end).toString())
. If
csq
is
null
, then the specified subsequence of the string "null"
will be written to the target.
csq | the character sequence appended to the target. |
---|---|
start | the index of the first char in the character sequence appended to the target. |
end | the index of the character following the last character of the subsequence appended to the target. |
IndexOutOfBoundsException |
if
start > end
,
start < 0
,
end < 0
or
either
start
or
end
are greater or equal than
the length of
csq
.
|
---|
Appends the character
c
to this writer's
StringBuffer
.
This method works the same way as
write(int)
.
c | the character to append to the target stream. |
---|
Calling this method has no effect. In contrast to most
Writer
subclasses,
the other methods in
StringWriter
do not throw an
IOException
if
close()
has been called.
IOException | if an error occurs while closing this writer. |
---|
Gets a reference to this writer's internal
StringBuffer
. Any
changes made to the returned buffer are reflected in this writer.
StringBuffer
.
Gets a copy of the contents of this writer as a string.
Writes the characters from the specified string to this writer's
StringBuffer
.
str | the non-null string containing the characters to write. |
---|
Writes
count
characters starting at
offset
in
buf
to this writer's
StringBuffer
.
chars | the non-null character array to write. |
---|---|
offset |
the index of the first character in
chars
to write.
|
count | the maximum number of characters to write. |
IndexOutOfBoundsException |
if
offset < 0
or
count < 0
, or if
offset + count
is greater than the size of
buf
.
|
---|
Writes
count
characters from
str
starting at
offset
to this writer's
StringBuffer
.
str | the non-null string containing the characters to write. |
---|---|
offset |
the index of the first character in
str
to write.
|
count |
the number of characters from
str
to write.
|
StringIndexOutOfBoundsException |
if
offset < 0
or
count < 0
, or if
offset + count
is greater than the length of
str
.
|
---|
Writes one character to this writer's
StringBuffer
. Only the two
least significant bytes of the integer
oneChar
are written.
oneChar |
the character to write to this writer's
StringBuffer
.
|
---|