---

java.io
Class CharArrayWriter

java.lang.Object
 |
 +--java.io.Writer
 |
 +--java.io.CharArrayWriter

---

public class CharArrayWriter

extends Writer

Untamed: 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().

Since:

JDK1.1

Version:

1.16, 12/03/01

Author:

Herb Jellinek

---

buf

protected char[] buf

The buffer where data is stored.

---

count

protected int count

The number of chars in the buffer.

CharArrayWriter

public CharArrayWriter()

Enabled: Creates a new CharArrayWriter.

---

CharArrayWriter

public CharArrayWriter(int initialSize)

Enabled: Creates a new CharArrayWriter with the specified initial size.

Parameters:

initialSize - an int specifying the initial buffer size.

write

public void write(int c)

Enabled: Writes a character to the buffer.

Overrides:

write in class Writer

Parameters:

c - int specifying a character to be written.

---

write

public void write(char[] c,
 int off,
 int len)

Enabled: Writes characters to the buffer.

Specified by:

write in class Writer

Parameters:

c - the data to be written

off - the start offset in the data

len - the number of chars that are written

---

write

public void write(String str,
 int off,
 int len)

Enabled: Write a portion of a string to the buffer.

Overrides:

write in class Writer

Parameters:

str - String to be written from

off - Offset from which to start reading characters

len - Number of characters to be written

---

writeTo

public void writeTo(Writer out)
 throws IOException

Enabled: 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.

---

reset

public void reset()

Enabled: Resets the buffer so that you can use it again without throwing away the already allocated buffer.

---

toCharArray

public char[] toCharArray()

Enabled: Returns a copy of the input data.

Returns:

an array of chars copied from the input data.

---

size

public int size()

Enabled: Returns the current size of the buffer.

Returns:

an int representing the current size of the buffer.

---

toString

public String toString()

Suppressed: Converts input data to a string.

Overrides:

toString in class Object

Returns:

the string.

---

flush

public void flush()

Enabled: Flush the stream.

Specified by:

flush in class Writer

---

close

public void close()

Enabled: Close the stream. This method does not release the buffer, since its contents might still be required.

Specified by:

close in class Writer

---

---