FilterInputStream.read

FilterInputStream.read

Class Overview | Class Members | This Package | All Packages

Syntax 1
public 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.

The read method of FilterInputStream calls the read method of its underlying input stream and returns whatever value that method returns.

Exceptions
IOException if an I/O error occurs.
Overrides
read in class InputStream
See Also
in



Syntax 2
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 if there is no more data because the end of the stream has been reached.
Description
Reads up to byte.length bytes of data from this input stream into an array of bytes. This method blocks until some input is available.

The read method of FilterInputStream calls the read method of three arguments with the arguments b, 0, and b.length, and returns whatever value that method returns.

Note that this method does not call the one-argument read method of its underlying stream with the single argument b. Subclasses of FilterInputStream do not need to override this method if they have overridden the three-argument read method.

Exceptions
IOException if an I/O error occurs.
Overrides
read in class InputStream
See Also
read



Syntax 3
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.

The read method of FilterInputStream calls the read method of its underlying input stream with the same arguments and returns whatever value that method returns.

Exceptions
IOException if an I/O error occurs.
Overrides
read in class InputStream
See Also
in