InputStream.read
Class Overview | Class Members |
This Package |
All Packages
public abstract int read() throws IOException
Returns
the next byte of data, or -1 if the end of the
stream is reached.
Description
Reads the next byte of data from this input stream. The value
byte is returned as an int in the range
0 to 255. If no byte is available
because the end of the stream has been reached, the value
-1 is returned. This method blocks until input data
is available, the end of the stream is detected, or an exception
is thrown.
A subclass must provide an implementation of this method.
Exceptions
IOException
if an I/O error occurs.
public int read( byte b[] ) throws IOException
Parameters
- b
- the buffer into which the data is read.
Returns
the total number of bytes read into the buffer, or
-1 is there is no more data because the end of
the stream has been reached.
Description
Reads up to b.length bytes of data from this input
stream into an array of bytes.
The read method of InputStream calls
the read method of three arguments with the arguments
b, 0, and b.length.
Exceptions
IOException
if an I/O error occurs.
See Also
read
public int read( byte b[],
int off,
int len ) throws IOException
Parameters
- b
- the buffer into which the data is read.
- off
- the start offset of the data.
- len
- the maximum number of bytes read.
Returns
the total number of bytes read into the buffer, or
-1 if there is no more data because the end of
the stream has been reached.
Description
Reads up to len bytes of data from this input stream
into an array of bytes. This method blocks until some input is
available. If the first argument is null, up to
len bytes are read and discarded.
The read method of InputStream reads a
single byte at a time using the read method of zero arguments to
fill in the array. Subclasses are encouraged to provide a more
efficient implementation of this method.
Exceptions
IOException
if an I/O error occurs.
See Also
read