All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class magician.Utils.ByteArrayDataOutStream

java.lang.Object
   |
   +----java.io.OutputStream
           |
           +----magician.Utils.ByteArrayDataOutStream

public class ByteArrayDataOutStream
extends OutputStream
implements DataOutput
A data input stream lets an application write primitive Java data types to an output stream in a portable way. An application can then use a data input stream to read the data back in.


Variable Index

 o buf
The buffer where data is stored.
 o written
The number of bytes written to the data output stream.

Constructor Index

 o ByteArrayDataOutStream()
Creates a new data output stream to write data to the specified underlying output stream.
 o ByteArrayDataOutStream(int)
initializes internal buffer to given size

Method Index

 o reset()
Resets the count field of this byte array output stream to zero, so that all currently accumulated output in the ouput stream is discarded.
 o size()
Returns the number of bytes written to this data output stream.
 o toByteArray()
Creates a newly allocated byte array.
 o toString()
Creates a newly allocated string.
 o write(byte[], int, int)
Writes len bytes from the specified byte array starting at offset off to the underlying output stream.
 o write(int)
Writes the specified byte to the underlying output stream.
 o writeBoolean(boolean)
Writes a boolean to the underlying output stream as a 1-byte value.
 o writeByte(int)
Writes out a byte to the underlying output stream as a 1-byte value.
 o writeBytes(String)
Writes out the string to the underlying output stream as a sequence of bytes.
 o writeChar(int)
Writes a char to the underlying output stream as a 2-byte value, high byte first.
 o writeChars(String)
Writes a string to the underlying output stream as a sequence of characters.
 o writeDouble(double)
Converts the double argument to a long using the doubleToLongBits method in class Double, and then writes that long value to the underlying output stream as an 8-byte quantity, high byte first.
 o writeFloat(float)
Converts the float argument to an int using the floatToIntBits method in class Float, and then writes that int value to the underlying output stream as a 4-byte quantity, high byte first.
 o writeInt(int)
Writes an int to the underlying output stream as four bytes, high byte first.
 o writeLong(long)
Writes a long to the underlying output stream as eight bytes, high byte first.
 o writeShort(int)
Writes a short to the underlying output stream as two bytes, high byte first.
 o writeTo(OutputStream)
Writes the complete contents of this byte array output stream to the specified output stream argument, as if by calling the output stream's write method using out.write(buf, 0, count).
 o writeUTF(String)
Writes a string to the underlying output stream using UTF-8 encoding in a machine-independent manner.

Variables

 o buf
 protected byte buf[]
The buffer where data is stored.

 o written
 protected int written
The number of bytes written to the data output stream.

Constructors

 o ByteArrayDataOutStream
 public ByteArrayDataOutStream()
Creates a new data output stream to write data to the specified underlying output stream.

Parameters:
out - the underlying output stream.
See Also:
out
 o ByteArrayDataOutStream
 public ByteArrayDataOutStream(int size)
initializes internal buffer to given size

Parameters:
size - size of buffer in bytes

Methods

 o writeTo
 public void writeTo(OutputStream out) throws IOException
Writes the complete contents of this byte array output stream to the specified output stream argument, as if by calling the output stream's write method using out.write(buf, 0, count).

Parameters:
out - the output stream to which to write the data.
Throws: IOException
if an I/O error occurs.
 o reset
 public void reset()
Resets the count field of this byte array output stream to zero, so that all currently accumulated output in the ouput stream is discarded. The output stream can be used again, reusing the already allocated buffer space.

See Also:
count
 o write
 public void write(int b) throws IOException
Writes the specified byte to the underlying output stream.

Parameters:
b - the byte to be written.
Throws: IOException
if an I/O error occurs.
Overrides:
write in class OutputStream
See Also:
out
 o write
 public void write(byte b[],
                   int off,
                   int len) throws IOException
Writes len bytes from the specified byte array starting at offset off to the underlying output stream.

Parameters:
b - the data.
off - the start offset in the data.
len - the number of bytes to write.
Throws: IOException
if an I/O error occurs.
Overrides:
write in class OutputStream
See Also:
out
 o writeBoolean
 public final void writeBoolean(boolean v) throws IOException
Writes a boolean to the underlying output stream as a 1-byte value. The value true is written out as the value (byte)1; the value false is written out as the value (byte)0.

Parameters:
v - a boolean value to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeByte
 public final void writeByte(int v) throws IOException
Writes out a byte to the underlying output stream as a 1-byte value.

Parameters:
v - a byte value to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeShort
 public final void writeShort(int v) throws IOException
Writes a short to the underlying output stream as two bytes, high byte first.

Parameters:
v - a short to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeChar
 public final void writeChar(int v) throws IOException
Writes a char to the underlying output stream as a 2-byte value, high byte first.

Parameters:
v - a char value to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeInt
 public final void writeInt(int v) throws IOException
Writes an int to the underlying output stream as four bytes, high byte first.

Parameters:
v - an int to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeLong
 public final void writeLong(long v) throws IOException
Writes a long to the underlying output stream as eight bytes, high byte first.

Parameters:
v - a long to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeFloat
 public final void writeFloat(float v) throws IOException
Converts the float argument to an int using the floatToIntBits method in class Float, and then writes that int value to the underlying output stream as a 4-byte quantity, high byte first.

Parameters:
v - a float value to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out, floatToIntBits
 o writeDouble
 public final void writeDouble(double v) throws IOException
Converts the double argument to a long using the doubleToLongBits method in class Double, and then writes that long value to the underlying output stream as an 8-byte quantity, high byte first.

Parameters:
v - a double value to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out, doubleToLongBits
 o writeBytes
 public final void writeBytes(String s) throws IOException
Writes out the string to the underlying output stream as a sequence of bytes. Each character in the string is written out, in sequence, by discarding its high eight bits.

Parameters:
s - a string of bytes to be written.
Throws: IOException
if an I/O error occurs.
See Also:
out
 o writeChars
 public final void writeChars(String s) throws IOException
Writes a string to the underlying output stream as a sequence of characters. Each character is written to the data output stream as if by the writeChar method.

Parameters:
s - a String value to be written.
Throws: IOException
if an I/O error occurs.
See Also:
writeChar, out
 o writeUTF
 public final void writeUTF(String str) throws IOException
Writes a string to the underlying output stream using UTF-8 encoding in a machine-independent manner.

First, two bytes are written to the output stream as if by the writeShort method giving the number of bytes to follow. This value is the number of bytes actually written out, not the length of the string. Following the length, each character of the string is output, in sequence, using the UTF-8 encoding for the character.

Parameters:
str - a string to be written.
Throws: IOException
if an I/O error occurs.
 o toString
 public String toString()
Creates a newly allocated string. Its size is the current size of this output stream and the valid contents of the buffer have been copied into it. Each character c in the resulting string is constructed from the corresponding element b in the byte array such that:

Returns:
the current contents of this output stream, as a string.
Overrides:
toString in class Object
See Also:
size
 o size
 public final int size()
Returns the number of bytes written to this data output stream.

Returns:
the value of the written field.
See Also:
written
 o 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.

Returns:
the current contents of this output stream, as a byte array.
See Also:
size

All Packages  Class Hierarchy  This Package  Previous  Next  Index
1