DataOutputStream (Java SE 9 & JDK 9 ) (original) (raw)
Field Detail
* #### written
protected int written
The number of bytes written to the data output stream so far. If this counter overflows, it will be wrapped to Integer.MAX\_VALUE.
Constructor Detail
* #### DataOutputStream
public DataOutputStream([OutputStream](../../java/io/OutputStream.html "class in java.io") out)
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:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
Method Detail
* #### write
public void write(int b)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[write](../../java/io/DataOutput.html#write-int-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Overrides:
`[write](../../java/io/FilterOutputStream.html#write-int-)` in class `[FilterOutputStream](../../java/io/FilterOutputStream.html "class in java.io")`
Parameters:
`b` \- the `byte` to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### write
public void write(byte[] b,
int off,
int len)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[write](../../java/io/DataOutput.html#write-byte:A-int-int-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Overrides:
`[write](../../java/io/FilterOutputStream.html#write-byte:A-int-int-)` in class `[FilterOutputStream](../../java/io/FilterOutputStream.html "class in java.io")`
Parameters:
`b` \- the data.
`off` \- the start offset in the data.
`len` \- the number of bytes to write.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### flush
public void flush()
throws [IOException](../../java/io/IOException.html "class in java.io")
Flushes this data output stream. This forces any buffered output bytes to be written out to the stream.
The `flush` method of `DataOutputStream` calls the `flush` method of its underlying output stream.
Specified by:
`[flush](../../java/io/Flushable.html#flush--)` in interface `[Flushable](../../java/io/Flushable.html "interface in java.io")`
Overrides:
`[flush](../../java/io/FilterOutputStream.html#flush--)` in class `[FilterOutputStream](../../java/io/FilterOutputStream.html "class in java.io")`
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out), [OutputStream.flush()](../../java/io/OutputStream.html#flush--)
* #### writeBoolean
public final void writeBoolean(boolean v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeBoolean](../../java/io/DataOutput.html#writeBoolean-boolean-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `boolean` value to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeByte
public final void writeByte(int v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeByte](../../java/io/DataOutput.html#writeByte-int-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `byte` value to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeShort
public final void writeShort(int v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeShort](../../java/io/DataOutput.html#writeShort-int-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `short` to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeChar
public final void writeChar(int v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeChar](../../java/io/DataOutput.html#writeChar-int-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `char` value to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeInt
public final void writeInt(int v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeInt](../../java/io/DataOutput.html#writeInt-int-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- an `int` to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeLong
public final void writeLong(long v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeLong](../../java/io/DataOutput.html#writeLong-long-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `long` to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeFloat
public final void writeFloat(float v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeFloat](../../java/io/DataOutput.html#writeFloat-float-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `float` value to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out), [Float.floatToIntBits(float)](../../java/lang/Float.html#floatToIntBits-float-)
* #### writeDouble
public final void writeDouble(double v)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeDouble](../../java/io/DataOutput.html#writeDouble-double-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`v` \- a `double` value to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out), [Double.doubleToLongBits(double)](../../java/lang/Double.html#doubleToLongBits-double-)
* #### writeBytes
public final void writeBytes([String](../../java/lang/String.html "class in java.lang") s)
throws [IOException](../../java/io/IOException.html "class in java.io")
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`.
Specified by:
`[writeBytes](../../java/io/DataOutput.html#writeBytes-java.lang.String-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`s` \- a string of bytes to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeChars
public final void writeChars([String](../../java/lang/String.html "class in java.lang") s)
throws [IOException](../../java/io/IOException.html "class in java.io")
Writes a string to the underlying output stream as a sequence of characters. Each character is written to the data output stream as if by the `writeChar` method. If no exception is thrown, the counter `written` is incremented by twice the length of `s`.
Specified by:
`[writeChars](../../java/io/DataOutput.html#writeChars-java.lang.String-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`s` \- a `String` value to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
See Also:
[writeChar(int)](../../java/io/DataOutputStream.html#writeChar-int-), [FilterOutputStream.out](../../java/io/FilterOutputStream.html#out)
* #### writeUTF
public final void writeUTF([String](../../java/lang/String.html "class in java.lang") str)
throws [IOException](../../java/io/IOException.html "class in java.io")
Writes a string to the underlying output stream using[modified UTF-8](DataInput.html#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`.
Specified by:
`[writeUTF](../../java/io/DataOutput.html#writeUTF-java.lang.String-)` in interface `[DataOutput](../../java/io/DataOutput.html "interface in java.io")`
Parameters:
`str` \- a string to be written.
Throws:
`[IOException](../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs.
* #### size
public final int size()
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.
Returns:
the value of the `written` field.
See Also:
[written](../../java/io/DataOutputStream.html#written)