to top
Android APIs
public class

DataOutputStream

extends FilterOutputStream
implements DataOutput
java.lang.Object
   ↳ java.io.OutputStream
     ↳ java.io.FilterOutputStream
       ↳ java.io.DataOutputStream

Class Overview

Wraps an existing OutputStream and writes big-endian typed data to it. Typically, this stream can be read in by DataInputStream. 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

Summary

Fields
protected int written The number of bytes written out so far.
[Expand]
Inherited Fields
From class java.io.FilterOutputStream
Public Constructors
DataOutputStream(OutputStream out)
Constructs a new DataOutputStream on the OutputStream out.
Public Methods
void flush()
Flushes this stream to ensure all pending data is sent out to the target stream.
final int size()
Returns the total number of bytes written to the target stream so far.
void write(int oneByte)
Writes a byte to the target stream.
void write(byte[] buffer, int offset, int count)
Writes count bytes from the byte array buffer starting at offset to the target stream.
final void writeBoolean(boolean val)
Writes a boolean to the target stream.
final void writeByte(int val)
Writes an 8-bit byte to the target stream.
final void writeBytes(String str)
Writes the low order 8-bit bytes from the specified string.
final void writeChar(int val)
Writes the specified 16-bit character in big-endian order.
final void writeChars(String str)
Writes the 16-bit characters contained in str in big-endian order.
final void writeDouble(double val)
Writes the specified 64-bit double in big-endian order.
final void writeFloat(float val)
Writes the specified 32-bit float in big-endian order.
final void writeInt(int val)
Writes the specified 32-bit int in big-endian order.
final void writeLong(long val)
Writes the specified 64-bit long in big-endian order.
final void writeShort(int val)
Writes the specified 16-bit short in big-endian order.
final void writeUTF(String str)
Writes the specified string encoded in modified UTF-8.
[Expand]
Inherited Methods
From class java.io.FilterOutputStream
From class java.io.OutputStream
From class java.lang.Object
From interface java.io.Closeable
From interface java.io.DataOutput
From interface java.io.Flushable

Fields

protected int written

Since: API Level 1

The number of bytes written out so far.

Public Constructors

public DataOutputStream (OutputStream out)

Since: API Level 1

Constructs a new DataOutputStream on the OutputStream out. Note that data written by this stream is not in a human readable form but can be reconstructed by using a DataInputStream on the resulting output.

Parameters
out the target stream for writing.

Public Methods

public void flush ()

Since: API Level 1

Flushes this stream to ensure all pending data is sent out to the target stream. This implementation then also flushes the target stream.

Throws
IOException if an error occurs attempting to flush this stream.

public final int size ()

Since: API Level 1

Returns the total number of bytes written to the target stream so far.

Returns
  • the number of bytes written to the target stream.

public void write (int oneByte)

Since: API Level 1

Writes a byte to the target stream. Only the least significant byte of the integer oneByte is written.

Parameters
oneByte the byte to write to the target stream.
Throws
IOException if an error occurs while writing to the target stream.
See Also

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

Since: API Level 1

Writes count bytes from the byte array buffer starting at offset to the target stream.

Parameters
buffer the buffer to write to the target stream.
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 error occurs while writing to the target stream.
NullPointerException if buffer is null.

public final void writeBoolean (boolean val)

Since: API Level 1

Writes a boolean to the target stream.

Parameters
val the boolean value to write to the target stream.
Throws
IOException if an error occurs while writing to the target stream.
See Also

public final void writeByte (int val)

Since: API Level 1

Writes an 8-bit byte to the target stream. Only the least significant byte of the integer val is written.

Parameters
val the byte value to write to the target stream.
Throws
IOException if an error occurs while writing to the target stream.
See Also

public final void writeBytes (String str)

Since: API Level 1

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

Parameters
str the string containing the bytes to write.
Throws
IOException

public final void writeChar (int val)

Since: API Level 1

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

public final void writeChars (String str)

Since: API Level 1

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

Parameters
str the string that contains the characters to write.
Throws
IOException

public final void writeDouble (double val)

Since: API Level 1

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

public final void writeFloat (float val)

Since: API Level 1

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

public final void writeInt (int val)

Since: API Level 1

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

Parameters
val the int to write.
Throws
IOException

public final void writeLong (long val)

Since: API Level 1

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

Parameters
val the long to write.
Throws
IOException

public final void writeShort (int val)

Since: API Level 1

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

public final void writeUTF (String str)

Since: API Level 1

Writes the specified string encoded in modified UTF-8.

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