| java.lang.Object
 java.io.Writer
java.io.CharArrayWriter
| CharArrayWriter | | public class CharArrayWriter extends Writer (Code) | | This class implements a character buffer that can be used as an Writer.
The buffer automatically grows when data is written to the stream. The data
can be retrieved using toCharArray() and toString().
Note: Invoking close() on this class has no effect, and methods
of this class can be called after the stream has closed
without generating an IOException.
author:
Herb Jellinek
version:
1.31, 05/05/07
since:
JDK1.1 |
| Field Summary | |
| protected char | buf
The buffer where data is stored. | | protected int | count
The number of chars in the buffer. |
| Constructor Summary | |
| public | CharArrayWriter()
Creates a new CharArrayWriter. | | public | CharArrayWriter(int initialSize)
Creates a new CharArrayWriter with the specified initial size. |
| Method Summary | |
| public CharArrayWriter | append(CharSequence csq)
Appends the specified character sequence to this writer.
An invocation of this method of the form out.append(csq)
behaves in exactly the same way as the invocation
out.write(csq.toString())
Depending on the specification of toString for the
character sequence csq, the entire sequence may not be
appended. | | public CharArrayWriter | append(CharSequence csq, int start, int end)
Appends a subsequence of the specified character sequence to this writer.
An invocation of this method of the form out.append(csq, start,
end) when csq is not null, behaves in
exactly the same way as the invocation
out.write(csq.subSequence(start, end).toString())
Parameters:
csq - The character sequence from which a subsequence will beappended. | | public CharArrayWriter | append(char c)
Appends the specified character to this writer. | | public void | close()
Close the stream. | | public void | flush()
Flush the stream. | | public void | reset()
Resets the buffer so that you can use it again without
throwing away the already allocated buffer. | | public int | size()
Returns the current size of the buffer. | | public char | toCharArray()
Returns a copy of the input data. | | public String | toString()
Converts input data to a string. | | public void | write(int c)
Writes a character to the buffer. | | public void | write(char c, int off, int len)
Writes characters to the buffer. | | public void | write(String str, int off, int len)
Write a portion of a string to the buffer. | | public void | writeTo(Writer out)
Writes the contents of the buffer to another character stream. |
| buf | | protected char buf(Code) | | The buffer where data is stored.
|
| count | | protected int count(Code) | | The number of chars in the buffer.
|
| CharArrayWriter | | public CharArrayWriter()(Code) | | Creates a new CharArrayWriter.
|
| CharArrayWriter | | public CharArrayWriter(int initialSize)(Code) | | Creates a new CharArrayWriter with the specified initial size.
Parameters:
initialSize - an int specifying the initial buffer size.
exception:
IllegalArgumentException - if initialSize is negative |
| append | | public CharArrayWriter append(CharSequence csq)(Code) | | Appends the specified character sequence to this writer.
An invocation of this method of the form out.append(csq)
behaves in exactly the same way as the invocation
out.write(csq.toString())
Depending on the specification of toString for the
character sequence csq, the entire sequence may not be
appended. For instance, invoking the toString method of a
character buffer will return a subsequence whose content depends upon
the buffer's position and limit.
Parameters:
csq - The character sequence to append. If csq isnull, then the four characters "null" areappended to this writer. This writer
since:
1.5 |
| append | | public CharArrayWriter append(CharSequence csq, int start, int end)(Code) | | Appends a subsequence of the specified character sequence to this writer.
An invocation of this method of the form out.append(csq, start,
end) when csq is not null, behaves in
exactly the same way as the invocation
out.write(csq.subSequence(start, end).toString())
Parameters:
csq - The character sequence from which a subsequence will beappended. If csq is null, then characterswill be appended as if csq contained the fourcharacters "null".
Parameters:
start - The index of the first character in the subsequence
Parameters:
end - The index of the character following the last character in thesubsequence This writer
throws:
IndexOutOfBoundsException - If start or end are negative, startis greater than end, or end is greater thancsq.length()
since:
1.5 |
| append | | public CharArrayWriter append(char c)(Code) | | Appends the specified character to this writer.
An invocation of this method of the form out.append(c)
behaves in exactly the same way as the invocation
out.write(c)
Parameters:
c - The 16-bit character to append This writer
since:
1.5 |
| close | | public void close()(Code) | | Close the stream. This method does not release the buffer, since its
contents might still be required. Note: Invoking this method in this class
will have no effect.
|
| flush | | public void flush()(Code) | | Flush the stream.
|
| reset | | public void reset()(Code) | | Resets the buffer so that you can use it again without
throwing away the already allocated buffer.
|
| size | | public int size()(Code) | | Returns the current size of the buffer.
an int representing the current size of the buffer. |
| toCharArray | | public char toCharArray()(Code) | | Returns a copy of the input data.
an array of chars copied from the input data. |
| toString | | public String toString()(Code) | | Converts input data to a string.
the string. |
| write | | public void write(int c)(Code) | | Writes a character to the buffer.
|
| write | | public void write(char c, int off, int len)(Code) | | Writes characters to the buffer.
Parameters:
c - the data to be written
Parameters:
off - the start offset in the data
Parameters:
len - the number of chars that are written |
| write | | public void write(String str, int off, int len)(Code) | | Write a portion of a string to the buffer.
Parameters:
str - String to be written from
Parameters:
off - Offset from which to start reading characters
Parameters:
len - Number of characters to be written |
| writeTo | | public void writeTo(Writer out) throws IOException(Code) | | Writes the contents of the buffer to another character stream.
Parameters:
out - the output stream to write to
throws:
IOException - If an I/O error occurs. |
|
|