java.io
public class StringBufferInputStream extends InputStream
String
to be read as an input stream.
The low eight bits of each character in the String
are the
bytes that are returned. The high eight bits of each character are
discarded.
The mark/reset functionality in this class behaves differently than
normal. The mark()
method is always ignored and the
reset()
method always resets in stream to start reading from
position 0 in the String. Note that since this method does not override
markSupported()
in InputStream
, calling that
method will return false
.
Note that this class is deprecated because it does not properly handle
16-bit Java characters. It is provided for backwards compatibility only
and should not be used for new development. The StringReader
class should be used instead.
Modifier and Type | Field and Description |
---|---|
protected String |
buffer
Deprecated.
The String which is the input to this stream.
|
protected int |
count
Deprecated.
The length of the String buffer.
|
protected int |
pos
Deprecated.
Position of the next byte in buffer to be read.
|
Constructor and Description |
---|
StringBufferInputStream(String s)
Deprecated.
Create a new
StringBufferInputStream that will read bytes
from the passed in String . |
Modifier and Type | Method and Description |
---|---|
int |
available()
Deprecated.
This method returns the number of bytes available to be read from this
stream.
|
int |
read()
Deprecated.
This method reads one byte from the stream.
|
int |
read(byte[] b,
int off,
int len)
Deprecated.
This method reads bytes from the stream and stores them into a caller
supplied buffer.
|
void |
reset()
Deprecated.
This method sets the read position in the stream to the beginning
setting the
pos variable equal to 0. |
long |
skip(long n)
Deprecated.
This method attempts to skip the requested number of bytes in the
input stream.
|
close, mark, markSupported, read
protected int pos
protected int count
public StringBufferInputStream(String s)
StringBufferInputStream
that will read bytes
from the passed in String
. This stream will read from the
beginning to the end of the String
.s
- The String
this stream will read from.public int available()
count - pos
.available
in class InputStream
public int read()
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.read
in class InputStream
public int read(byte[] b, int off, int len)
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.
read
in class InputStream
b
- The array into which the bytes read should be stored.off
- The offset into the array to start storing byteslen
- The requested number of bytes to readpublic void reset()
pos
variable equal to 0. Note that this differs
from the common implementation of the reset()
method.reset
in class InputStream
public long skip(long n)
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.skip
in class InputStream
n
- The requested number of bytes to skip