All Packages  This Package  Class Hierarchy  Class Search  Index

java.lang.Object
   |
   +----java.io.InputStream
           |
           +----java.io.FilterInputStream
                   |
                   +----kh.io.CountingInputStream

Summary

public class  CountingInputStream
     extends java.io.FilterInputStream
{
          // Constructors 2
     public CountingInputStream(InputStream);
     public CountingInputStream(InputStream, long);

          // Methods 7
     public long getCount();
     public void mark(int);
     public int read() throws IOException;
     public int read(byte[]) throws IOException;
     public int read(byte[], int, int) throws IOException;
     public void reset() throws IOException;
     public long skip(long) throws IOException;
}

An input stream which keeps the current character offset

Constructors

· CountingInputStream

Summary  |  Top

   public CountingInputStream(InputStream source) 

   public CountingInputStream(InputStream source, 
                              long initialCount) 

   public long getCount() 

   public void mark(int readlimit) 

Marks the current position in this input stream. A subsequent call to the reset method repositions this stream at the last marked position so that subsequent reads re-read the same bytes.

The readlimit argument tells this input stream to allow that many bytes to be read before the mark position gets invalidated.

The mark method of FilterInputStream calls the mark method of its underlying input stream with the readlimit argument.

Parameter	Description
readlimit	the maximum limit of bytes that can be read before the mark position becomes invalid.

Overrides:

mark in class FilterInputStream

See Also: in, reset

   public int read()  throws IOException

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.

Returns:

the next byte of data, or -1 if the end of the stream is reached.

Throws: IOException

if an I/O error occurs.

Overrides:

read in class FilterInputStream

See Also: in

   public int read(byte[] b)  throws IOException

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.

Parameter	Description
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.

Throws: IOException

if an I/O error occurs.

Overrides:

read in class FilterInputStream

See Also: read

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

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.

Parameter	Description
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.

Throws: IOException

if an I/O error occurs.

Overrides:

read in class FilterInputStream

See Also: in

   public void reset()  throws IOException

Repositions this stream to the position at the time the mark method was last called on this input stream.

The reset method of FilterInputStream calls the reset method of its underlying input stream.

Stream marks are intended to be used in situations where you need to read ahead a little to see what's in the stream. Often this is most easily done by invoking some general parser. If the stream is of the type handled by the parse, it just chugs along happily. If the stream is not of that type, the parser should toss an exception when it fails. If this happens within readlimit bytes, it allows the outer code to reset the stream and try another parser.

Throws: IOException

if the stream has not been marked or if the mark has been invalidated.

Overrides:

reset in class FilterInputStream

See Also: in, mark

   public long skip(long n)  throws IOException

Skips over and discards n bytes of data from the input stream. The skip method may, for a variety of reasons, end up skipping over some smaller number of bytes, possibly 0. The actual number of bytes skipped is returned.

The skip method of FilterInputStream calls the skip method of its underlying input stream with the same argument, and returns whatever value that method does.

Parameter	Description
n	the number of bytes to be skipped.

Returns:

the actual number of bytes skipped.

Throws: IOException

if an I/O error occurs.

Overrides:

skip in class FilterInputStream

All Packages  This Package  Class Hierarchy  Class Search  Index