java.io
Interface DataOutput

All Known Subinterfaces:

ObjectOutput

All Known Implementing Classes:

DataOutputStream, ObjectOutputStream, RandomAccessFile

public interface DataOutput

DataOutput is an interface which declares methods for writing typed data to a Stream. Typically, this stream can be read in by a class which implements DataInput. Types that can be written include byte, 16-bit short, 32-bit int, 32-bit float, 64-bit long, 64-bit double, byte strings, and UTF Strings.

See Also:

DataOutputStream, RandomAccessFile

Method Summary

void	write(byte[] buffer) Writes the entire contents of the byte array buffer to the OutputStream.
void	write(byte[] buffer, int offset, int count) Writes count bytes from the byte array buffer starting at offset index to the OutputStream.
void	write(int oneByte) Writes the specified byte to the OutputStream.
void	writeBoolean(boolean val) Writes a boolean to this output stream.
void	writeByte(int val) Writes a 8-bit byte to this output stream.
void	writeBytes(String str) Writes the low order 8-bit bytes from a String to this output stream.
void	writeChar(int oneByte) Writes the specified 16-bit character to the OutputStream.
void	writeChars(String str) Writes the specified 16-bit characters contained in str to the OutputStream.
void	writeDouble(double val) Writes a 64-bit double to this output stream.
void	writeFloat(float val) Writes a 32-bit float to this output stream.
void	writeInt(int val) Writes a 32-bit int to this output stream.
void	writeLong(long val) Writes a 64-bit long to this output stream.
void	writeShort(int val) Writes the specified 16-bit short to the OutputStream.
void	writeUTF(String str) Writes the specified String out in UTF format.

Method Detail

write

void write(byte[] buffer)
           throws IOException

Writes the entire contents of the byte array buffer to the OutputStream.

Parameters:

buffer - the buffer to be written

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readFully(byte[]), DataInput.readFully(byte[], int, int)

write

void write(byte[] buffer,
           int offset,
           int count)
           throws IOException

Writes count bytes from the byte array buffer starting at offset index to the OutputStream.

Parameters:

buffer - the buffer to be written

offset - offset in buffer to get bytes

count - number of bytes in buffer to write

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readFully(byte[]), DataInput.readFully(byte[], int, int)

write

void write(int oneByte)
           throws IOException

Writes the specified byte to the OutputStream.

Parameters:

oneByte - the byte to be written

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readByte()

writeBoolean

void writeBoolean(boolean val)
                  throws IOException

Writes a boolean to this output stream.

Parameters:

val - the boolean value to write to the OutputStream

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readBoolean()

writeByte

void writeByte(int val)
               throws IOException

Writes a 8-bit byte to this output stream.

Parameters:

val - the byte value to write to the OutputStream

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readByte(), DataInput.readUnsignedByte()

writeBytes

void writeBytes(String str)
                throws IOException

Writes the low order 8-bit bytes from a String to this output stream.

Parameters:

str - the String containing the bytes to write to the OutputStream

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readFully(byte[]), DataInput.readFully(byte[],int,int)

writeChar

void writeChar(int oneByte)
               throws IOException

Writes the specified 16-bit character to the OutputStream. Only the lower 2 bytes are written with the higher of the 2 bytes written first. This represents the Unicode value of val.

Parameters:

oneByte - the character to be written

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readChar()

writeChars

void writeChars(String str)
                throws IOException

Writes the specified 16-bit characters contained in str to the OutputStream. Only the lower 2 bytes of each character are written with the higher of the 2 bytes written first. This represents the Unicode value of each character in str.

Parameters:

str - the String whose characters are to be written.

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readChar()

writeDouble

void writeDouble(double val)
                 throws IOException

Writes a 64-bit double to this output stream. The resulting output is the 8 bytes resulting from calling Double.doubleToLongBits().

Parameters:

val - the double to be written.

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readDouble()

writeFloat

void writeFloat(float val)
                throws IOException

Writes a 32-bit float to this output stream. The resulting output is the 4 bytes resulting from calling Float.floatToIntBits().

Parameters:

val - the float to be written.

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readFloat()

writeInt

void writeInt(int val)
              throws IOException

Writes a 32-bit int to this output stream. The resulting output is the 4 bytes, highest order first, of val.

Parameters:

val - the int to be written.

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readInt()

writeLong

void writeLong(long val)
               throws IOException

Writes a 64-bit long to this output stream. The resulting output is the 8 bytes, highest order first, of val.

Parameters:

val - the long to be written.

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readLong()

writeShort

void writeShort(int val)
                throws IOException

Writes the specified 16-bit short to the OutputStream. Only the lower 2 bytes are written with the higher of the 2 bytes written first.

Parameters:

val - the short to be written

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readShort(), DataInput.readUnsignedShort()

writeUTF

void writeUTF(String str)
              throws IOException

Writes the specified String out in UTF format.

Parameters:

str - the String to be written in UTF format.

Throws:

IOException - If an error occurs attempting to write to this stream.

See Also:

DataInput.readUTF()