22.3

java.io.InputStream

THE PACKAGE JAVA.IO

exception is returned from the call to the

read(b, off, len)

 method. If any sub 

sequent call to

read()

 results in a

IOException

, the exception is caught and

treated as if it were end of file; the bytes read up to that point are stored into

b

 and

the number of bytes read before the exception occurred is returned.

22.3.4

public long skip(long n) throws IOException

The general contract of

skip

 is that it makes an attempt to skip over

n

 bytes of

data from the input stream, discarding the skipped bytes. However, it may skip

over some smaller number of bytes, possibly zero. This may result from any of a

number of conditions; reaching end of file before

n

 bytes have been skipped is

only one possibility. The actual number of bytes skipped is returned.

22.3.5

public int available() throws IOException

The general contract of

available

 is that it returns an integer

k

; the next caller of

a method for this input stream, which might be the same thread or another thread,

can then expect to be able to read or skip up to

k

 bytes without blocking (waiting

for input data to arrive).

The

available

 method for class

InputStream

 always returns

0

.

22.3.6

public int close() throws IOException

The general contract of

close

 is that it closes the input stream. A closed stream

cannot perform input operations and cannot be reopened.

The

close

 method for class

InputStream

 does nothing and simply returns.

22.3.7

public void mark(int readlimit)

The general contract of

mark

 is that, if the method

markSupported

 returns

true

,

the stream somehow remembers all the bytes read after the call to

mark

 and stands

ready to supply those same bytes again if and whenever the method

reset

 is

called. However, the stream is not required to remember any data at all if more

than

readlimit

 bytes are read from the stream before

reset

 is called.

The

mark

 method for class

InputStream

 does nothing.

682