DataInputStream is not necessarily safe for multithreaded access. Thread safety is optional and is the responsibility of users of methods in this class.
DataOutputStreamb. The number of
bytes actually read is returned as an integer. This method blocks
until input data is available, end of file is detected, or an
exception is thrown.
If b is null, a NullPointerException is
thrown. If the length of b is zero, then no bytes are
read and 0 is returned; otherwise, there is an attempt
to read at least one byte. If no byte is available because the
stream is at end of file, the value -1 is returned;
otherwise, at least one byte is read and stored into b.
The first byte read is stored into element b[0], the
next one into b[1], and so on. The number of bytes read
is, at most, equal to the length of b. Let k
be the number of bytes actually read; these bytes will be stored in
elements b[0] through b[k-1], leaving
elements b[k] through b[b.length-1]
unaffected.
The read(b) method has the same effect as:
read(b, 0, b.length)
b the buffer into which the data is read.-1 if there is no more data because the end
of the stream has been reached.IOException if the first byte cannot be read for any reason
other than end of file, the stream has been closed and the underlying
input stream does not support reading after close, or another I/O
error occurs.FilterInputStream.inInputStream.read(byte[],int,int)len bytes of data from the contained
input stream into an array of bytes. An attempt is made to read
as many as len bytes, but a smaller number may be read,
possibly zero. The number of bytes actually read is returned as an
integer.
This method blocks until input data is available, end of file is detected, or an exception is thrown.
If len is zero, then no bytes are read and
0 is returned; otherwise, there is an attempt to read at
least one byte. If no byte is available because the stream is at end of
file, the value -1 is returned; otherwise, at least one
byte is read and stored into b.
The first byte read is stored into element b[off], the
next one into b[off+1], and so on. The number of bytes read
is, at most, equal to len. Let k be the number of
bytes actually read; these bytes will be stored in elements
b[off] through b[off+k-1],
leaving elements b[off+k] through
b[off+len-1] unaffected.
In every case, elements b[0] through
b[off] and elements b[off+len] through
b[b.length-1] are unaffected.
b the buffer into which the data is read.off the start offset in the destination array blen the maximum number of bytes read.-1 if there is no more data because the end
of the stream has been reached.java.lang.NullPointerException If b is null.java.lang.IndexOutOfBoundsException If off is negative,
len is negative, or len is greater than
b.length - offIOException if the first byte cannot be read for any reason
other than end of file, the stream has been closed and the underlying
input stream does not support reading after close, or another I/O
error occurs.FilterInputStream.inInputStream.read(byte[],int,int)readFully
method of DataInput.
Bytes for this operation are read from the contained input stream.
b the buffer into which the data is read.EOFException if this input stream reaches the end before
reading all the bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadFully
method of DataInput.
Bytes for this operation are read from the contained input stream.
b the buffer into which the data is read.off the start offset of the data.len the number of bytes to read.EOFException if this input stream reaches the end before
reading all the bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inskipBytes
method of DataInput.
Bytes for this operation are read from the contained input stream.
n the number of bytes to be skipped.IOException if the contained input stream does not support
seek, or the stream has been closed and
the contained input stream does not support
reading after close, or another I/O error occurs.readBoolean
method of DataInput.
Bytes for this operation are read from the contained input stream.
boolean value read.EOFException if this input stream has reached the end.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadByte
method of DataInput.
Bytes for this operation are read from the contained input stream.
byte.EOFException if this input stream has reached the end.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadUnsignedByte
method of DataInput.
Bytes for this operation are read from the contained input stream.
EOFException if this input stream has reached the end.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadShort
method of DataInput.
Bytes for this operation are read from the contained input stream.
EOFException if this input stream reaches the end before
reading two bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadUnsignedShort
method of DataInput.
Bytes for this operation are read from the contained input stream.
EOFException if this input stream reaches the end before
reading two bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadChar
method of DataInput.
Bytes for this operation are read from the contained input stream.
char.EOFException if this input stream reaches the end before
reading two bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadInt
method of DataInput.
Bytes for this operation are read from the contained input stream.
int.EOFException if this input stream reaches the end before
reading four bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadLong
method of DataInput.
Bytes for this operation are read from the contained input stream.
long.EOFException if this input stream reaches the end before
reading eight bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.FilterInputStream.inreadFloat
method of DataInput.
Bytes for this operation are read from the contained input stream.
float.EOFException if this input stream reaches the end before
reading four bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.readInt()java.lang.Float.intBitsToFloat(int)readDouble
method of DataInput.
Bytes for this operation are read from the contained input stream.
double.EOFException if this input stream reaches the end before
reading eight bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.readLong()java.lang.Double.longBitsToDouble(long)readLine
method of DataInput.
Bytes for this operation are read from the contained input stream.
BufferedReader.readLine() method. Programs that use the
DataInputStream class to read lines can be converted to use
the BufferedReader class by replacing code of the form:
DataInputStream d = new DataInputStream(in);
with:
BufferedReader d
= new BufferedReader(new InputStreamReader(in));
IOException if an I/O error occurs.BufferedReader.readLine()FilterInputStream.inreadUTF
method of DataInput.
Bytes for this operation are read from the contained input stream.
EOFException if this input stream reaches the end before
reading all the bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.UTFDataFormatException if the bytes do not represent a valid
modified UTF-8 encoding of a string.readUTF(java.io.DataInput)in a representation
of a Unicode character string encoded in
modified UTF-8 format;
this string of characters is then returned as a String.
The details of the modified UTF-8 representation
are exactly the same as for the readUTF
method of DataInput.
in a data input stream.EOFException if the input stream reaches the end
before all the bytes.IOException the stream has been closed and the contained
input stream does not support reading after close, or
another I/O error occurs.UTFDataFormatException if the bytes do not represent a
valid modified UTF-8 encoding of a Unicode string.readUnsignedShort()