THE PACKAGE JAVA.IO

java.io.InputStream

22.3

22.3.8

public void reset() throws IOException

The general contract of

reset

 is:

If the method

markSupported

 returns

true

, then:

N

If the method

mark

 has not been called since the stream was created, or the

number of bytes read from the stream since

mark

 was last called is larger

than the argument to

mark

 at that last call, then an

IOException

 might be

thrown.

N

If such an

IOException

 is not thrown, then the stream is reset to a state

such that all the bytes read since the most recent call to

mark

 (or since the

start of the file, if

mark

 has not been called) will be resupplied to subsequent

callers of the

read

 method, followed by any bytes that otherwise would

have been the next input data as of the time of the call to

reset

.

If the method

markSupported

 returns

false

, then:

N

The call to

reset

 may throw an

IOException

.

N

If an

IOException

 is not thrown, then the stream is reset to a fixed state

that depends on the particular type of the input stream and how it was cre 

ated. The bytes that will be supplied to subsequent callers of the

read

method depend on the particular type of the input stream.

The method

reset

 for class

InputStream

 always throws an

IOException

.

22.3.9

public boolean markSupported()

The general contract of

markSupported

 is that if it returns

true

, then the stream

supports the

mark

 ( 22.3.7) and

reset

 ( 22.3.8) operations. For any given

instance of

InputStream

, this method should consistently return the same truth

value whenever it is called.

The

markSupported

 method for class

InputStream

 returns

false

.

683