public class CharArrayWriter extends Writer
The size of the internal buffer defaults to 32 and it is resized in increments of 1024 chars. This behavior can be over-ridden by using the following two properties:
There is a constructor that specified the initial buffer size and that is the preferred way to set that value because it it portable across all Java class library implementations.
Modifier and Type | Field and Description |
---|---|
protected char[] |
buf
The internal buffer where the data written is stored
|
protected int |
count
The number of chars that have been written to the buffer
|
Constructor and Description |
---|
CharArrayWriter()
This method initializes a new
CharArrayWriter with
the default buffer size of 32 chars. |
CharArrayWriter(int size)
This method initializes a new
CharArrayWriter with
a specified initial buffer size. |
Modifier and Type | Method and Description |
---|---|
void |
close()
Closes the stream.
|
void |
flush()
This method flushes all buffered chars to the stream.
|
void |
reset()
This method discards all of the chars that have been written to the
internal buffer so far by setting the
count variable to
0. |
int |
size()
This method returns the number of chars that have been written to
the buffer so far.
|
char[] |
toCharArray()
This method returns a char array containing the chars that have been
written to this stream so far.
|
String |
toString()
Returns the chars in the internal array as a
String . |
void |
write(char[] buffer,
int offset,
int len)
This method writes
len chars from the passed in array
buf starting at index offset into that buffer |
void |
write(int oneChar)
This method writes the writes the specified char into the internal
buffer.
|
void |
write(String str,
int offset,
int len)
This method writes
len chars from the passed in
String buf starting at index
offset into the internal buffer. |
void |
writeTo(Writer out)
This method writes all the chars that have been written to this stream
from the internal buffer to the specified
Writer . |
protected char[] buf
protected int count
public CharArrayWriter()
CharArrayWriter
with
the default buffer size of 32 chars. If a different initial
buffer size is desired, see the constructor
CharArrayWriter(int size)
.public CharArrayWriter(int size)
CharArrayWriter
with
a specified initial buffer size.size
- The initial buffer size in charspublic void close()
public void flush()
public void reset()
count
variable to
0. The internal buffer remains at its currently allocated size.public int size()
count
variable. If the reset
method is
called, then this value is reset as well. Note that this method does
not return the length of the internal buffer, but only the number
of chars that have been written to it.reset()
public char[] toCharArray()
public String toString()
String
. The
chars in the buffer are converted to characters using the system default
encoding. There is an overloaded toString()
method that
allows an application specified character encoding to be used.public void write(int oneChar)
public void write(char[] buffer, int offset, int len)
len
chars from the passed in array
buf
starting at index offset
into that bufferpublic void write(String str, int offset, int len)
len
chars from the passed in
String
buf
starting at index
offset
into the internal buffer.public void writeTo(Writer out) throws IOException
Writer
.out
- The Writer
to write toIOException
- If an error occurs