java.lang.Object | +--java.io.InputStream | +--java.io.FilterInputStream | +--java.io.DataInputStream
Safe:
DataInputStream(InputStream in)
int
read(byte[] b)
b.
int
read(byte[] b,
int off,
int len)
len bytes of data from the contained
input stream into an array of bytes.
void
readFully(byte[] b,
int off,
int len)
readFully
method of DataInput.
String
readLine()
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:
with:DataInputStream d = new DataInputStream(in);
BufferedReader d = new BufferedReader(new InputStreamReader(in));
int
readUnsignedByte()
readUnsignedByte
method of DataInput.
int
readUnsignedShort()
readUnsignedShort
method of DataInput.
static String
readUTF(DataInput in)
in a representation
of a Unicode character string encoded in
Java modified UTF-8 format; this string
of characters is then returned as a String.
private char[] lineBuffer
public DataInputStream(InputStream in)
in - the specified input streampublic final int read(byte[] b) throws IOException
b. 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.
If the first byte cannot be read for any reason other than end of
file, then an IOException is thrown. In particular, an
IOException is thrown if the input stream has been closed.
The read(b) method has the same effect as:
read(b, 0, b.length)
read in class FilterInputStreamb - the buffer into which the data is read.
-1 if there is no more data because the end
of the stream has been reached.
IOExceptionjava.io.FilterInputStream#in,
java.io.InputStream#read(byte[], int, int)public final int read(byte[] b, int off, int len) throws IOException
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 b is null, a
NullPointerException is thrown.
If off is negative, or len is negative, or
off+len is greater than the length of the array
b, then an IndexOutOfBoundsException 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.
If the first byte cannot be read for any reason other than end of
file, then an IOException is thrown. In particular, an
IOException is thrown if the input stream has been closed.
read in class FilterInputStreamb - the buffer into which the data is read.off - the start offset of the data.len - the maximum number of bytes read.
-1 if there is no more data because the end
of the stream has been reached.
IOExceptionjava.io.FilterInputStream#in,
java.io.InputStream#read(byte[], int, int)public final void readFully(byte[] b) throws IOException
readFully
method of DataInput.
Bytes for this operation are read from the contained input stream.
b - the buffer into which the data is read.
IOExceptionjava.io.FilterInputStream#inpublic final void readFully(byte[] b, int off, int len) throws IOException
readFully
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.
IOExceptionjava.io.FilterInputStream#inpublic final int skipBytes(int n) throws IOException
skipBytes
method of DataInput.
Bytes for this operation are read from the contained input stream.
n - the number of bytes to be skipped.
IOExceptionpublic final boolean readBoolean() throws IOException
readBoolean
method of DataInput.
Bytes for this operation are read from the contained input stream.
readBoolean in interface DataInputboolean value read.
IOExceptionjava.io.FilterInputStream#inpublic final byte readByte() throws IOException
readByte
method of DataInput.
Bytes for this operation are read from the contained input stream.
byte.
IOExceptionjava.io.FilterInputStream#inpublic final int readUnsignedByte() throws IOException
readUnsignedByte
method of DataInput.
Bytes for this operation are read from the contained input stream.
readUnsignedByte in interface DataInputIOExceptionjava.io.FilterInputStream#inpublic final short readShort() throws IOException
readShort
method of DataInput.
Bytes for this operation are read from the contained input stream.
IOExceptionjava.io.FilterInputStream#inpublic final int readUnsignedShort() throws IOException
readUnsignedShort
method of DataInput.
Bytes for this operation are read from the contained input stream.
readUnsignedShort in interface DataInputIOExceptionjava.io.FilterInputStream#inpublic final char readChar() throws IOException
readChar
method of DataInput.
Bytes for this operation are read from the contained input stream.
IOExceptionjava.io.FilterInputStream#inpublic final int readInt() throws IOException
readInt
method of DataInput.
Bytes for this operation are read from the contained input stream.
int.
IOExceptionjava.io.FilterInputStream#inpublic final long readLong() throws IOException
readLong
method of DataInput.
Bytes for this operation are read from the contained input stream.
long.
IOExceptionjava.io.FilterInputStream#inpublic final float readFloat() throws IOException
readFloat
method of DataInput.
Bytes for this operation are read from the contained input stream.
float.
IOExceptionjava.io.DataInputStream#readInt(),
java.lang.Float#intBitsToFloat(int)public final double readDouble() throws IOException
readDouble
method of DataInput.
Bytes for this operation are read from the contained input stream.
readDouble in interface DataInputdouble.
IOExceptionjava.io.DataInputStream#readLong(),
java.lang.Double#longBitsToDouble(long)public final String readLine() throws IOException
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:
with:DataInputStream d = new DataInputStream(in);
BufferedReader d = new BufferedReader(new InputStreamReader(in));
readLine
method of DataInput.
Bytes for this operation are read from the contained input stream.
IOExceptionjava.io.BufferedReader#readLine(),
java.io.FilterInputStream#inpublic final String readUTF() throws IOException
readUTF
method of DataInput.
Bytes for this operation are read from the contained input stream.
IOExceptionjava.io.DataInputStream#readUTF(java.io.DataInput)public static final String readUTF(DataInput in) throws IOException
in a representation
of a Unicode character string encoded in
Java 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.
IOExceptionjava.io.DataInputStream#readUnsignedShort()