Class StringBufferInputStream

protected String buffer

The String which is the input to this stream.

protected int count

The length of the String buffer.

protected int pos

Position of the next byte in buffer to be read.

public StringBufferInputStream(String s)

Create a new StringBufferInputStream that will read bytes from the passed in String. This stream will read from the beginning to the end of the String.

Parameters:

s - The String this stream will read from.

public int available()

This method returns the number of bytes available to be read from this stream. The value returned will be equal to count - pos.

Overrides:

available in interface InputStream

Returns:

The number of bytes that can be read from this stream before blocking, which is all of them

public int read()

This method reads one byte from the stream. The pos counter is advanced to the next byte to be read. The byte read is returned as an int in the range of 0-255. If the stream position is already at the end of the buffer, no byte is read and a -1 is returned in order to indicate the end of the stream.

Overrides:

read in interface InputStream

Returns:

The byte read, or -1 if end of stream

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

This method reads bytes from the stream and stores them into a caller supplied buffer. It starts storing the data at index offset into the buffer and attempts to read len bytes. This method can return before reading the number of bytes requested if the end of the stream is encountered first. The actual number of bytes read is returned. If no bytes can be read because the stream is already at the end of stream position, a -1 is returned.

This method does not block.

Overrides:

read in interface InputStream

Parameters:

b - The array into which the bytes read should be stored.

off - The offset into the array to start storing bytes

len - The requested number of bytes to read

Returns:

The actual number of bytes read, or -1 if end of stream.

public void reset()

This method sets the read position in the stream to the beginning setting the pos variable equal to 0. Note that this differs from the common implementation of the reset() method.

Overrides:

reset in interface InputStream

public long skip(long n)

This method attempts to skip the requested number of bytes in the input stream. It does this by advancing the pos value by the specified number of bytes. It this would exceed the length of the buffer, then only enough bytes are skipped to position the stream at the end of the buffer. The actual number of bytes skipped is returned.

Overrides:

skip in interface InputStream

Parameters:

n - The requested number of bytes to skip

Returns:

The actual number of bytes skipped.