LineNumberInputStream.read

LineNumberInputStream.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 this 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 LineNumberInputStream calls the read method of the underlying input stream. It checks for carriage returns and newline characters in the input, and modifies the current line number as appropriate. A carriage-return character or a carriage return followed by a newline character are both converted into a single newline character.

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



Syntax 2
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 this 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 LineNumberInputStream repeatedly calls the read method of zero arguments to fill in the byte array.

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