org.htmlparser.lexer
public abstract class Source extends Reader implements Serializable
new InputStreamReader (connection.getInputStream (), charset)It differs from the above, in three ways:
Field Summary | |
---|---|
static int | EOF
Return value when the source is exhausted.
|
Method Summary | |
---|---|
abstract int | available()
Get the number of available characters. |
abstract void | close()
Does nothing.
|
abstract void | destroy()
Close the source.
|
abstract char | getCharacter(int offset)
Retrieve a character again. |
abstract void | getCharacters(char[] array, int offset, int start, int end)
Retrieve characters again. |
abstract void | getCharacters(StringBuffer buffer, int offset, int length)
Append characters already read into a StringBuffer . |
abstract String | getEncoding()
Get the encoding being used to convert characters. |
abstract String | getString(int offset, int length)
Retrieve a string comprised of characters already read. |
abstract void | mark(int readAheadLimit)
Mark the present position.
|
abstract boolean | markSupported()
Tell whether this source supports the mark() operation. |
abstract int | offset()
Get the position (in characters). |
abstract int | read()
Read a single character.
|
abstract int | read(char[] cbuf, int off, int len)
Read characters into a portion of an array. |
abstract int | read(char[] cbuf)
Read characters into an array.
|
abstract boolean | ready()
Tell whether this source is ready to be read. |
abstract void | reset()
Reset the source.
|
abstract void | setEncoding(String character_set)
Set the encoding to the given character set.
|
abstract long | skip(long n)
Skip characters.
|
abstract void | unread()
Undo the read of a single character. |
Returns: The number of characters that can be read without blocking.
Throws: IOException not used
See Also: Source
read
,
ready
, mark
, reset
,
skip
, unread
,
getCharacter
or getString
invocations will throw an IOException.
Closing a previously-closed source, however, has no effect.Throws: IOException If an I/O error occurs.
Parameters: offset The offset of the character.
Returns: The character at offset
.
Throws: IOException If the source is closed or the offset is beyond offset.
Parameters: array The array of characters. offset The starting position in the array where characters are to be placed. start The starting position, zero based. end The ending position (exclusive, i.e. the character at the ending position is not included), zero based.
Throws: IOException If the source is closed or the start or end is beyond offset.
StringBuffer
.Parameters: buffer The buffer to append to. offset The offset of the first character. length The number of characters to retrieve.
Throws: IOException If the source is closed or the offset or (offset + length) is beyond offset.
Returns: The current encoding.
Parameters: offset The offset of the first character. length The number of characters to retrieve.
Returns: A string containing the length
characters at offset
.
Throws: IOException If the source is closed.
Parameters: readAheadLimit The minimum number of characters that can be read before this mark becomes invalid.
Throws: IOException If an I/O error occurs.
Returns: true
if and only if this source supports the mark
operation.
Returns: The number of characters that have already been read, or EOF if the source is closed.
Returns: The character read, as an integer in the range 0 to 65535 (0x00-0xffff), or EOF if the source is exhausted.
Throws: IOException If an I/O error occurs.
Parameters: cbuf Destination buffer off Offset at which to start storing characters len Maximum number of characters to read
Returns: The number of characters read, or EOF if the source is exhausted.
Throws: IOException If an I/O error occurs.
Parameters: cbuf Destination buffer.
Returns: The number of characters read, or EOF if the source is exhausted.
Throws: IOException If an I/O error occurs.
Returns: true
if the next read() is guaranteed not to block
for input, false
otherwise.
Note that returning false does not guarantee that the next read will block.
Throws: IOException If an I/O error occurs.
If characters have already been consumed from this source, it is expected that an exception will be thrown if the characters read so far would be different if the encoding being set was used from the start.
Parameters: character_set The character set to use to convert characters.
Throws: ParserException If a character mismatch occurs between characters already provided and those that would have been returned had the new character set been in effect from the beginning. An exception is also thrown if the character set is not recognized.
Parameters: n The number of characters to skip.
Returns: The number of characters actually skipped
Throws: IOException If an I/O error occurs.
Throws: IOException If the source is closed or no characters have been read.
HTML Parser is an open source library released under LGPL. | |