| |
|
| java.lang.Object
 java.io.OutputStream
java.io.FilterOutputStream
java.io.DataOutputStream
| DataOutputStream | | public class DataOutputStream extends FilterOutputStream implements DataOutput(Code) | | A data output 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.
author:
unascribed
version:
1.50, 05/05/07
See Also: java.io.DataInputStream
since:
JDK1.0 |
| Field Summary | |
| protected int | written
The number of bytes written to the data output stream so far. |
| Constructor Summary | |
| public | DataOutputStream(OutputStream out)
Creates a new data output stream to write data to the specified
underlying output stream. |
| Method Summary | |
| public void | flush()
Flushes this data output stream. | | final public int | size()
Returns the current value of the counter written,
the number of bytes written to this data output stream so far. | | public synchronized void | write(int b)
Writes the specified byte (the low eight bits of the argument
b) to the underlying output stream. | | public synchronized void | write(byte b, int off, int len)
Writes len bytes from the specified byte array
starting at offset off to the underlying output stream. | | final public void | writeBoolean(boolean v)
Writes a boolean to the underlying output stream as
a 1-byte value. | | final public void | writeByte(int v)
Writes out a byte to the underlying output stream as
a 1-byte value. | | final public void | writeBytes(String s)
Writes out the string to the underlying output stream as a
sequence of bytes. | | final public void | writeChar(int v)
Writes a char to the underlying output stream as a
2-byte value, high byte first. | | final public void | writeChars(String s)
Writes a string to the underlying output stream as a sequence of
characters. | | final public void | writeDouble(double v)
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. | | final public void | writeFloat(float v)
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. | | final public void | writeInt(int v)
Writes an int to the underlying output stream as four
bytes, high byte first. | | final public void | writeLong(long v)
Writes a long to the underlying output stream as eight
bytes, high byte first. | | final public void | writeShort(int v)
Writes a short to the underlying output stream as two
bytes, high byte first. | | final public void | writeUTF(String str)
Writes a string to the underlying output stream using
modified UTF-8
encoding in a machine-independent manner. | | static int | writeUTF(String str, DataOutput out)
Writes a string to the specified DataOutput using
modified UTF-8
encoding in a machine-independent manner. |
| written | | protected int written(Code) | | The number of bytes written to the data output stream so far.
If this counter overflows, it will be wrapped to Integer.MAX_VALUE.
|
| DataOutputStream | | public DataOutputStream(OutputStream out)(Code) | | Creates a new data output stream to write data to the specified
underlying output stream. The counter written is
set to zero.
Parameters:
out - the underlying output stream, to be saved for later use.
See Also: java.io.FilterOutputStream.out |
| size | | final public int size()(Code) | | Returns the current value of the counter written,
the number of bytes written to this data output stream so far.
If the counter overflows, it will be wrapped to Integer.MAX_VALUE.
the value of the written field.
See Also: java.io.DataOutputStream.written |
| write | | public synchronized void write(int b) throws IOException(Code) | | Writes the specified byte (the low eight bits of the argument
b) to the underlying output stream. If no exception
is thrown, the counter written is incremented by
1.
Implements the write method of OutputStream.
Parameters:
b - the byte to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| write | | public synchronized void write(byte b, int off, int len) throws IOException(Code) | | Writes len bytes from the specified byte array
starting at offset off to the underlying output stream.
If no exception is thrown, the counter written is
incremented by len.
Parameters:
b - the data.
Parameters:
off - the start offset in the data.
Parameters:
len - the number of bytes to write.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeBoolean | | final public void writeBoolean(boolean v) throws IOException(Code) | | 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. If no exception is
thrown, the counter written is incremented by
1.
Parameters:
v - a boolean value to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeByte | | final public void writeByte(int v) throws IOException(Code) | | Writes out a byte to the underlying output stream as
a 1-byte value. If no exception is thrown, the counter
written is incremented by 1.
Parameters:
v - a byte value to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeBytes | | final public void writeBytes(String s) throws IOException(Code) | | 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. If no exception is
thrown, the counter written is incremented by the
length of s.
Parameters:
s - a string of bytes to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeChar | | final public void writeChar(int v) throws IOException(Code) | | Writes a char to the underlying output stream as a
2-byte value, high byte first. If no exception is thrown, the
counter written is incremented by 2.
Parameters:
v - a char value to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeDouble | | final public void writeDouble(double v) throws IOException(Code) | | 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. If no
exception is thrown, the counter written is
incremented by 8.
Parameters:
v - a double value to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out
See Also: java.lang.Double.doubleToLongBits(double) |
| writeFloat | | final public void writeFloat(float v) throws IOException(Code) | | 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. If no
exception is thrown, the counter written is
incremented by 4.
Parameters:
v - a float value to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out
See Also: java.lang.Float.floatToIntBits(float) |
| writeInt | | final public void writeInt(int v) throws IOException(Code) | | Writes an int to the underlying output stream as four
bytes, high byte first. If no exception is thrown, the counter
written is incremented by 4.
Parameters:
v - an int to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeLong | | final public void writeLong(long v) throws IOException(Code) | | Writes a long to the underlying output stream as eight
bytes, high byte first. In no exception is thrown, the counter
written is incremented by 8.
Parameters:
v - a long to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeShort | | final public void writeShort(int v) throws IOException(Code) | | Writes a short to the underlying output stream as two
bytes, high byte first. If no exception is thrown, the counter
written is incremented by 2.
Parameters:
v - a short to be written.
exception:
IOException - if an I/O error occurs.
See Also: java.io.FilterOutputStream.out |
| writeUTF | | final public void writeUTF(String str) throws IOException(Code) | | Writes a string to the underlying output stream using
modified 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 modified UTF-8 encoding
for the character. If no exception is thrown, the counter
written is incremented by the total number of
bytes written to the output stream. This will be at least two
plus the length of str, and at most two plus
thrice the length of str.
Parameters:
str - a string to be written.
exception:
IOException - if an I/O error occurs. |
| writeUTF | | static int writeUTF(String str, DataOutput out) throws IOException(Code) | | Writes a string to the specified DataOutput using
modified UTF-8
encoding in a machine-independent manner.
First, two bytes are written to out 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
modified UTF-8 encoding for the character. If no exception is thrown, the
counter written is incremented by the total number of
bytes written to the output stream. This will be at least two
plus the length of str, and at most two plus
thrice the length of str.
Parameters:
str - a string to be written.
Parameters:
out - destination to write to The number of bytes written out.
exception:
IOException - if an I/O error occurs. |
|
|
|