java.io.DataOutputStream
DataOutputStream is a filter class which can write typed data to a Stream.
Typically, this stream can be read in by a 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 UTF Strings.
Summary
Fields
protected |
|
|
int |
written |
The number of bytes written out so far |
Public Constructors
Public Methods
|
|
|
|
|
void |
close() |
|
|
|
|
|
void |
flush() |
|
|
|
|
|
void |
write(byte[] buffer) |
abstract |
|
|
|
|
void |
write(int oneByte) |
|
|
|
|
|
void |
write(byte[] buffer, int offset, int count) |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
write,
write,
write,
writeBoolean,
writeByte,
writeBytes,
writeChar,
writeChars,
writeDouble,
writeFloat,
writeInt,
writeLong,
writeShort,
writeUTF
Details
Fields
protected
int
written
The number of bytes written out so far
Public Constructors
public
DataOutputStream(OutputStream out)
Constructs a new DataOutputStream on the OutputStream
out
.
All writes can now be filtered through this stream. Note that data
written by this Stream is not in a human readable format but can be
reconstructed by using a DataInputStream on the resulting output.
Parameters
out
| the target OutputStream to filter writes on.
|
Public Methods
public
void
flush()
Flush this DataOutputStream to ensure all pending data is sent out to the
target OutputStream. This implementation flushes the target OutputStream.
Throws
IOException
| If an error occurs attempting to flush this DataOutputStream.
|
public
final
int
size()
Returns the total number of bytes written to this stream thus far.
Returns
- the number of bytes written to this DataOutputStream.
public
void
write(int oneByte)
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
DataOutputStream. |
public
void
write(byte[] buffer, int offset, int count)
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
DataOutputStream. |
public
final
void
writeBoolean(boolean val)
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
DataOutputStream. |
public
final
void
writeByte(int val)
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
DataOutputStream. |
public
final
void
writeBytes(String str)
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
DataOutputStream. |
public
final
void
writeChar(int val)
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
val
| the character to be written |
Throws
IOException
| If an error occurs attempting to write to this
DataOutputStream. |
public
final
void
writeChars(String str)
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
DataOutputStream. |
public
final
void
writeDouble(double val)
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
DataOutputStream. |
public
final
void
writeFloat(float val)
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
DataOutputStream. |
public
final
void
writeInt(int val)
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
DataOutputStream. |
public
final
void
writeLong(long val)
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
DataOutputStream. |
public
final
void
writeShort(int val)
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
DataOutputStream. |
public
final
void
writeUTF(String str)
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
DataOutputStream. |