22.12

java.io.LineNumberInputStream

THE PACKAGE JAVA.IO

22.12.3

public int read(byte[] b)

throws IOException, NullPointerException

See the general contract of the

read

 method of

InputStream

 ( 22.3.2).

As bytes are read from the contained input stream, line terminators are recog 

nized and counted. For each line terminator recognized in the contained input

stream, a single character

 \n 

 is returned.

Overrides the

read

 method of

FilterInputStream

 ( 22.9.4).

22.12.4

public int read(byte[] b, int off, int len)

throws IOException, NullPointerException,

IndexOutOfBoundsException

See the general contract of the

read

 method of

InputStream

 ( 22.3.3).

As bytes are read from the contained input stream, line terminators are recog 

nized and counted. For each line terminator recognized in the contained input

stream, a single character

 \n 

 is returned.

Overrides the

read

 method of

FilterInputStream

 ( 22.9.5).

22.12.5

public long skip(long n) throws IOException

See the general contract of the

skip

 method of

InputStream

 ( 22.3.4).

As bytes are read from the contained input stream, line terminators are recog 

nized and counted. Each line terminator recognized in the contained input stream

is considered to be a single byte skipped, even if it is the sequence

\r\n

.

Overrides the

skip

 method of

FilterInputStream

 ( 22.9.6).

22.12.6

public int available() throws IOException

See the general contract of the

available

 method of

InputStream

 ( 22.3.5).

Note that if the contained input stream is able to supply

k

 input characters

without blocking, the

LineNumberInputStream

 can guarantee only to provide

k

2  characters without blocking, because the

k

 characters from the contained

input stream might consist of

k

2

\r\n

 pairs, which will be converted to just

k

2

 \n 

 characters.

Overrides the

available

 method of

FilterInputStream

 ( 22.9.7).

708