Source

java.lang.Object
- java.io.Reader
- - org.htmlparser.lexer.Source

所有已实现的接口:

java.io.Closeable, java.io.Serializable, java.lang.AutoCloseable, java.lang.Readable

直接已知子类:

InputStreamSource, StringSource
```
public abstract class Source
extends java.io.Reader
implements java.io.Serializable
```
A buffered source of characters. A Source is very similar to a Reader, like:
```
 new InputStreamReader (connection.getInputStream (), charset)
 
```
It differs from the above, in three ways:
- the fetching of bytes may be asynchronous
- the character set may be changed, which resets the input stream
- characters may be requested more than once, so in general they will be buffered
另请参阅:

序列化表格

字段概要

字段
限定符和类型字段和说明

static int EOF
Return value when the source is exhausted.

字段
限定符和类型	字段和说明
`static int`	`EOF` Return value when the source is exhausted.

构造器概要

构造器
构造器和说明

Source()

构造器
构造器和说明
`Source()`

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`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(java.lang.StringBuffer buffer, int offset, int length)` Append characters already read into a `StringBuffer`.
`abstract java.lang.String`	`getEncoding()` Get the encoding being used to convert characters.
`abstract java.lang.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)` Read characters into an array.
`abstract int`	`read(char[] cbuf, int off, int len)` Read characters into a portion of an array.
`abstract boolean`	`ready()` Tell whether this source is ready to be read.
`abstract void`	`reset()` Reset the source.
`abstract void`	`setEncoding(java.lang.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.

从类继承的方法 java.io.Reader
read

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - EOF
```
public static final int EOF
```
    Return value when the source is exhausted. Has a value of -1.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Source
```
public Source()
```
- 方法详细资料
  - getEncoding
```
public abstract java.lang.String getEncoding()
```
    Get the encoding being used to convert characters.
    
    返回:
    
    The current encoding.
  - setEncoding
```
public abstract void setEncoding(java.lang.String character_set)
                          throws ParserException
```
    Set the encoding to the given character set. If the current encoding is the same as the requested encoding, this method is a no-op. Otherwise any subsequent characters read from this source will have been decoded using the given character set.
    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.
    
    参数:
    
    character_set - The character set to use to convert characters.
    
    抛出:
    
    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.
  - close
```
public abstract void close()
                    throws java.io.IOException
```
    Does nothing. It's supposed to close the source, but use destroy() instead.
    
    指定者:
    
    close 在接口中 java.io.Closeable
    
    指定者:
    
    close 在接口中 java.lang.AutoCloseable
    
    指定者:
    
    close 在类中 java.io.Reader
    
    抛出:
    
    java.io.IOException - not used
    
    另请参阅:
    
    destroy()
  - read
```
public abstract int read()
                  throws java.io.IOException
```
    Read a single character. This method will block until a character is available, an I/O error occurs, or the source is exhausted.
    
    覆盖:
    
    read 在类中 java.io.Reader
    
    返回:
    
    The character read, as an integer in the range 0 to 65535 (0x00-0xffff), or EOF if the source is exhausted.
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - read
```
public abstract int read(char[] cbuf,
                         int off,
                         int len)
                  throws java.io.IOException
```
    Read characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the source is exhausted.
    
    指定者:
    
    read 在类中 java.io.Reader
    
    参数:
    
    cbuf - Destination buffer
    
    off - Offset at which to start storing characters
    
    len - Maximum number of characters to read
    
    返回:
    
    The number of characters read, or EOF if the source is exhausted.
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - read
```
public abstract int read(char[] cbuf)
                  throws java.io.IOException
```
    Read characters into an array. This method will block until some input is available, an I/O error occurs, or the source is exhausted.
    
    覆盖:
    
    read 在类中 java.io.Reader
    
    参数:
    
    cbuf - Destination buffer.
    
    返回:
    
    The number of characters read, or EOF if the source is exhausted.
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - ready
```
public abstract boolean ready()
                       throws java.io.IOException
```
    Tell whether this source is ready to be read.
    
    覆盖:
    
    ready 在类中 java.io.Reader
    
    返回:
    
    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.
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - reset
```
public abstract void reset()
```
    Reset the source. Repositions the read point to begin at zero.
    
    覆盖:
    
    reset 在类中 java.io.Reader
  - markSupported
```
public abstract boolean markSupported()
```
    Tell whether this source supports the mark() operation.
    
    覆盖:
    
    markSupported 在类中 java.io.Reader
    
    返回:
    
    true if and only if this source supports the mark operation.
  - mark
```
public abstract void mark(int readAheadLimit)
                   throws java.io.IOException
```
    Mark the present position. Subsequent calls to reset() will attempt to reposition the source to this point. Not all sources support the mark() operation.
    
    覆盖:
    
    mark 在类中 java.io.Reader
    
    参数:
    
    readAheadLimit - The minimum number of characters that can be read before this mark becomes invalid.
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - skip
```
public abstract long skip(long n)
                   throws java.io.IOException
```
    Skip characters. This method will block until some characters are available, an I/O error occurs, or the source is exhausted. Note: n is treated as an int
    
    覆盖:
    
    skip 在类中 java.io.Reader
    
    参数:
    
    n - The number of characters to skip.
    
    返回:
    
    The number of characters actually skipped
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - unread
```
public abstract void unread()
                     throws java.io.IOException
```
    Undo the read of a single character.
    
    抛出:
    
    java.io.IOException - If the source is closed or no characters have been read.
  - getCharacter
```
public abstract char getCharacter(int offset)
                           throws java.io.IOException
```
    Retrieve a character again.
    
    参数:
    
    offset - The offset of the character.
    
    返回:
    
    The character at offset.
    
    抛出:
    
    java.io.IOException - If the source is closed or the offset is beyond offset().
  - getCharacters
```
public abstract void getCharacters(char[] array,
                                   int offset,
                                   int start,
                                   int end)
                            throws java.io.IOException
```
    Retrieve characters again.
    
    参数:
    
    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.
    
    抛出:
    
    java.io.IOException - If the source is closed or the start or end is beyond offset().
  - getString
```
public abstract java.lang.String getString(int offset,
                                           int length)
                                    throws java.io.IOException
```
    Retrieve a string comprised of characters already read.
    
    参数:
    
    offset - The offset of the first character.
    
    length - The number of characters to retrieve.
    
    返回:
    
    A string containing the length characters at offset.
    
    抛出:
    
    java.io.IOException - If the source is closed.
  - getCharacters
```
public abstract void getCharacters(java.lang.StringBuffer buffer,
                                   int offset,
                                   int length)
                            throws java.io.IOException
```
    Append characters already read into a StringBuffer.
    
    参数:
    
    buffer - The buffer to append to.
    
    offset - The offset of the first character.
    
    length - The number of characters to retrieve.
    
    抛出:
    
    java.io.IOException - If the source is closed or the offset or (offset + length) is beyond offset().
  - destroy
```
public abstract void destroy()
                      throws java.io.IOException
```
    Close the source. Once a source has been closed, further read, ready, mark, reset, skip, unread, getCharacter or getString invocations will throw an IOException. Closing a previously-closed source, however, has no effect.
    
    抛出:
    
    java.io.IOException - If an I/O error occurs.
  - offset
```
public abstract int offset()
```
    Get the position (in characters).
    
    返回:
    
    The number of characters that have already been read, or EOF if the source is closed.
  - available
```
public abstract int available()
```
    Get the number of available characters.
    
    返回:
    
    The number of characters that can be read without blocking.

类 Source

字段概要

构造器概要

方法概要

从类继承的方法 java.io.Reader

从类继承的方法 java.lang.Object

字段详细资料

EOF

构造器详细资料

Source

方法详细资料

getEncoding

setEncoding

close

read

read

read

ready

reset

markSupported

mark

skip

unread

getCharacter

getCharacters

getString

getCharacters

destroy

offset

available