|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--java.io.OutputStream
|
+--java.io.DataOutputStream
A data input 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.
DataInputStream| Field Summary | ||
protected OutputStream |
out
The output stream |
|
| Constructor Summary | ||
DataOutputStream(OutputStream out)
Creates a new data output stream to write data to the specified underlying output stream. |
||
| Method Summary | ||
void |
close()
Closes this output stream and releases any system resources associated with the stream. |
|
void |
flush()
Flushes this data output stream. |
|
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. |
|
void |
write(int b)
Writes the specified byte (the low eight bits of the argument b) to the underlying output stream. |
|
void |
writeBoolean(boolean v)
Writes a boolean to the underlying output stream as
a 1-byte value. |
|
void |
writeByte(int v)
Writes out a byte to the underlying output stream as
a 1-byte value. |
|
void |
writeChar(int v)
Writes a char to the underlying output stream as a
2-byte value, high byte first. |
|
void |
writeChars(String s)
Writes a string to the underlying output stream as a sequence of characters. |
|
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. |
|
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. |
|
void |
writeInt(int v)
Writes an int to the underlying output stream as four
bytes, high byte first. |
|
void |
writeLong(long v)
Writes a long to the underlying output stream as eight
bytes, high byte first. |
|
void |
writeShort(int v)
Writes a short to the underlying output stream as two
bytes, high byte first. |
|
void |
writeUTF(String str)
Writes a string to the underlying output stream using UTF-8 encoding in a machine-independent manner. |
|
| Methods inherited from class java.io.OutputStream |
write |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface java.io.DataOutput |
write |
| Field Detail |
| Constructor Detail |
public DataOutputStream(OutputStream out)
written is
set to zero.out - the underlying output stream, to be saved for later
use.| Method Detail |
public void close()
throws IOException
The close method
calls its flush method, and then calls the
close method of its underlying output stream.
close in class OutputStreamIOException - if an I/O error occurs.
public void flush()
throws IOException
The flush method of DataOutputStream
calls the flush method of its underlying output stream.
flush in class OutputStreamIOException - if an I/O error occurs.
public void write(byte[] b,
int off,
int len)
throws IOException
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.write in interface DataOutputwrite in class OutputStreamb - the data.off - the start offset in the data.len - the number of bytes to write.IOException - if an I/O error occurs.
public void write(int b)
throws IOException
b) to the underlying output stream. If no exception
is thrown, the counter written is incremented by
1.
Implements the write method of OutputStream.
write in interface DataOutputwrite in class OutputStreamb - the byte to be written.IOException - if an I/O error occurs.
public final void writeBoolean(boolean v)
throws IOException
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.v - a boolean value to be written.IOException - if an I/O error occurs.
public final void writeByte(int v)
throws IOException
byte to the underlying output stream as
a 1-byte value. If no exception is thrown, the counter
written is incremented by 1.v - a byte value to be written.IOException - if an I/O error occurs.
public final void writeChar(int v)
throws IOException
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.v - a char value to be written.IOException - if an I/O error occurs.public final void writeChars(String s) throws IOException
writeChar method. If no exception is
thrown, the counter written is incremented by twice
the length of s.s - a String value to be written.IOException - if an I/O error occurs.writeChar(int)
public final void writeDouble(double v)
throws IOException
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.v - a double value to be written.IOException - if an I/O error occurs.Double.doubleToLongBits(double)
public final void writeFloat(float v)
throws IOException
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.v - a float value to be written.IOException - if an I/O error occurs.Float.floatToIntBits(float)
public final void writeInt(int v)
throws IOException
int to the underlying output stream as four
bytes, high byte first. If no exception is thrown, the counter
written is incremented by 4.v - an int to be written.IOException - if an I/O error occurs.
public final void writeLong(long v)
throws IOException
long to the underlying output stream as eight
bytes, high byte first. In no exception is thrown, the counter
written is incremented by 8.v - a long to be written.IOException - if an I/O error occurs.
public final void writeShort(int v)
throws IOException
short to the underlying output stream as two
bytes, high byte first. If no exception is thrown, the counter
written is incremented by 2.v - a short to be written.IOException - if an I/O error occurs.public final void writeUTF(String str) throws IOException
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 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.
str - a string to be written.IOException - if an I/O error occurs.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.