|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.io.Writer
java.io.StringWriter
public class StringWriter
This class writes chars to an internal StringBuffer
that
can then be used to retrieve a String
.
Field Summary |
---|
Fields inherited from class java.io.Writer |
---|
lock |
Constructor Summary | |
---|---|
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. |
Method Summary | |
---|---|
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. |
Methods inherited from class java.io.Writer |
---|
write |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
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
Method Detail |
---|
public void close() throws IOException
close
in interface Closeable
close
in class Writer
IOException
- If an error orrurs.public void flush()
flush
in interface Flushable
flush
in class Writer
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)
write
in class Writer
oneChar
- The char
to write, passed as an int.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.
write
in class Writer
chars
- The array of chars to writeoffset
- The index into the array to start writing fromlen
- The number of chars to writepublic void write(String str)
String
to the stream by appending them to the end of the internal buffer.
write
in class Writer
str
- The String
to write to the stream.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.
write
in class Writer
str
- The String
to write characters fromoffset
- The character position to start writing fromlen
- The number of characters to write.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.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |