public class ByteArrayOutputStream

Object
OutputStream
ByteArrayOutputStream

This class implements an output stream in which the data is written into a byte array. The buffer automatically grows as data is written to it. The data can be retrieved using toByteArray() and toString(). Since: JDK1.0, CLDC 1.0

Fields

`protected byte[] buf`	The buffer where data is stored.
`protected int count`	The number of valid bytes in the buffer.

Constructors

`public ByteArrayOutputStream()`	Creates a new byte array output stream.
`public ByteArrayOutputStream(int size)`	Creates a new byte array output stream, with a buffer capacity of the specified size, in bytes.

Methods

`public void close() throwsIOException`	Closes this output stream and releases any system resources associated with this stream.
`public void reset()`	Resets the count field of this byte array output stream to zero, so that all currently accumulated output in the output stream is discarded.
`public int size()`	Returns the current size of the buffer.
`public byte[] toByteArray()`	Creates a newly allocated byte array.
`public` `String toString()`	Converts the buffer’s contents into a string, translating bytes into characters according to the platform’s default character encoding.
`public` `String toString(String charsetName) throws UnsupportedEncodingException`	Converts the buffer’s contents into a string, translating bytes into characters according to the named charset.
`public void write(byte[] b, int off, int len)`	Writes len bytes from the specified byte array starting at offset off to this byte array output stream.
`public void write(int b)`	Writes the specified byte to this byte array output stream.

Inherited methods

From OutputStream

flush, write

From Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait, clone

Field details

buf

protected byte[] buf

The buffer where data is stored.

count

protected int count

The number of valid bytes in the buffer.

Constructor details

ByteArrayOutputStream

public ByteArrayOutputStream()

Creates a new byte array output stream. The buffer capacity is initially 32 bytes, though its size increases if necessary.

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

Creates a new byte array output stream, with a buffer capacity of the specified size, in bytes. size - the initial size.

if size is negative.

Method details

close

public void close()
throws IOException

Closes this output stream and releases any system resources associated with this stream. A closed stream cannot perform output operations and cannot be reopened.

Throws

IOException

reset

public void reset()

Resets the count field of this byte array output stream to zero, so that all currently accumulated output in the output stream is discarded. The output stream can be used again, reusing the already allocated buffer space.

size

public int size()

Returns the current size of the buffer.

toByteArray

public byte[] toByteArray()

Creates a newly allocated byte array. Its size is the current size of this output stream and the valid contents of the buffer have been copied into it.

toString

public String toString()

Converts the buffer’s contents into a string, translating bytes into characters according to the platform’s default character encoding.

toString

public String toString(String charsetName)
throws UnsupportedEncodingException

Converts the buffer’s contents into a string, translating bytes into characters according to the named charset.

Throws

UnsupportedEncodingException

write

public void write(byte[] b, int off, int len)

Writes len bytes from the specified byte array starting at offset off to this byte array output stream.

write

public void write(int b)

Writes the specified byte to this byte array output stream.