java.io

Class BufferedInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.io.BufferedInputStream

public class BufferedInputStream
extends FilterInputStream

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	buf
protected int	count
protected int	marklimit
protected int	markpos
protected int	pos

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
BufferedInputStream(InputStream in) Creates a BufferedInputStream and saves its argument, the input stream in, for later use.
BufferedInputStream(InputStream in, int size) Creates a BufferedInputStream with the specified buffer size, and saves its argument, the input stream in, for later use.

Method Summary

Modifier and Type	Method and Description
int	available() Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream.
void	mark(int rlimit) Mark the current position in the stream.
boolean	markSupported() Tests if this input stream supports the mark and reset methods.
int	read() Reads the next byte of data.
int	read(byte[] arr, int ofs, int len) Reads bytes from this byte-input stream into the specified byte array, starting at the given offset.
void	reset() The stream is positioned to the last mark.
long	skip(long cnt) Skip a number of bytes from the input stream.

Methods inherited from class java.io.FilterInputStream

close, read

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

buf

protected byte[] buf

count

protected int count

pos

protected int pos

markpos

protected int markpos

marklimit

protected int marklimit

Constructor Detail

BufferedInputStream

public BufferedInputStream(InputStream in)

Creates a BufferedInputStream and saves its argument, the input stream in, for later use.

Parameters:

in - the underlying input stream.

BufferedInputStream

public BufferedInputStream(InputStream in,
                           int size)

Creates a BufferedInputStream with the specified buffer size, and saves its argument, the input stream in, for later use.

Parameters:

in - the underlying input stream.

size - the buffer size.

Method Detail

available

public int available()
              throws IOException

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream. The next invocation might be the same thread or another thread. A single read or skip of this many bytes will not block, but may read or skip fewer bytes.

Overrides:

available in class FilterInputStream

Returns:

an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking.

Throws:

IOException - if this input stream has been closed by invoking its close() method, or an I/O error occurs.

mark

public void mark(int rlimit)

Mark the current position in the stream.

Overrides:

mark in class FilterInputStream

Parameters:

rlimit - the maximum limit of bytes that can be read before the mark position becomes invalid.

markSupported

public boolean markSupported()

Tests if this input stream supports the mark and reset methods.

Overrides:

markSupported in class FilterInputStream

Returns:

boolean indicating if this stream type supports the mark and reset methods.

read

public int read()
         throws IOException

Reads the next byte of data.

Overrides:

read in class FilterInputStream

Returns:

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

Throws:

IOException - if this input stream has been closed by invoking its close() method, or an I/O error occurs.

read

public int read(byte[] arr,
                int ofs,
                int len)
         throws IOException

Reads bytes from this byte-input stream into the specified byte array, starting at the given offset.

Overrides:

read in class FilterInputStream

Parameters:

arr - destination array

ofs - offset at which to start storing bytes

len - maximum number of bytes to read

Returns:

the number of bytes read, or -1 if the end of the stream has been reached.

Throws:

IOException - if this input stream has been closed by invoking its close() method, or an I/O error occurs.

reset

public void reset()
           throws IOException

The stream is positioned to the last mark.

Overrides:

reset in class FilterInputStream

Throws:

IOException - if this stream has not been marked or, if the mark has been invalidated, or the stream has been closed by invoking its close() method, or an I/O error occurs.

skip

public long skip(long cnt)
          throws IOException

Skip a number of bytes from the input stream.

Overrides:

skip in class FilterInputStream

Parameters:

cnt - the number of bytes to be skipped.

Returns:

the actual number of bytes skipped.

Throws:

IOException - if the stream does not support seek, or if this input stream has been closed by invoking its close() method, or an I/O error occurs.