DataOutput

public interface DataOutput

Known Indirect Subclasses DataOutputStream, ObjectOutput, ObjectOutputStream, RandomAccessFile DataOutputStream Wraps an existing OutputStream and writes big-endian typed data to it.  ObjectOutput Defines an interface for classes that allow reading serialized objects.  ObjectOutputStream A specialized OutputStream that is able to write (serialize) Java objects as well as primitive data types (int, byte, char etc.).  RandomAccessFile Allows reading from and writing to a file in a random-access manner.

Defines an interface for classes that are able to write big-endian typed data to some target. Typically, this data 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 MUTF-8 encoded strings.

See Also

• DataOutputStream
• RandomAccessFile

Public Method Summary

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

Public Methods

public abstract void write (byte[] buffer)

Writes the entire contents of the byte array buffer to this stream.

Parameters

buffer	the buffer to write.

Throws

IOException	if an I/O error occurs while writing.

public abstract void write (byte[] buffer, int offset, int count)

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

Parameters

buffer	the buffer to write.
offset	the index of the first byte in buffer to write.
count	the number of bytes from the buffer to write.

Throws

IOException	if an I/O error occurs while writing.

public abstract void write (int oneByte)

Writes the specified 8-bit byte.

Parameters

oneByte	the byte to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readByte()

public abstract void writeBoolean (boolean val)

Writes the specified boolean.

Parameters

val	the boolean value to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readBoolean()

public abstract void writeByte (int val)

Writes the specified 8-bit byte.

Parameters

val	the byte value to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readByte()
• readUnsignedByte()

public abstract void writeBytes (String str)

Writes the low order 8-bit bytes from the specified string.

Parameters

str	the string containing the bytes to write.

Throws

IOException	if an I/O error occurs while writing.

public abstract void writeChar (int val)

Writes the specified 16-bit character in big-endian order. Only the two least significant bytes of the integer oneByte are written.

Parameters

val	the character to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readChar()

public abstract void writeChars (String str)

Writes the 16-bit characters contained in str in big-endian order.

Parameters

str	the string that contains the characters to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readChar()

public abstract void writeDouble (double val)

Writes the specified 64-bit double in big-endian order. The resulting output is the eight bytes returned by doubleToLongBits(double).

Parameters

val	the double to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readDouble()

public abstract void writeFloat (float val)

Writes the specified 32-bit float in big-endian order. The resulting output is the four bytes returned by floatToIntBits(float).

Parameters

val	the float to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readFloat()

public abstract void writeInt (int val)

Writes the specified 32-bit int in big-endian order.

Parameters

val	the int to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readInt()

public abstract void writeLong (long val)

Writes the specified 64-bit long in big-endian order.

Parameters

val	the long to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readLong()

public abstract void writeShort (int val)

Writes the specified 16-bit short in big-endian order. Only the lower two bytes of val are written.

Parameters

val	the short to write.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readShort()
• readUnsignedShort()

public abstract void writeUTF (String str)

Writes the specified string encoded in modified UTF-8.

Parameters

str	the string to write encoded in modified UTF-8.

Throws

IOException	if an I/O error occurs while writing.

See Also

• readUTF()