XTokenQueue (xsoup 0.3.1 API)

java.lang.Object
- us.codecraft.xsoup.XTokenQueue

```
public class XTokenQueue
extends Object
```
A character queue with parsing helpers.
Most code borrowed from TokenQueue

作者:

Jonathan Hedley

另请参阅:

TokenQueue

构造器概要

构造器
构造器和说明

XTokenQueue(String data)
Create a new TokenQueue.

构造器
构造器和说明
`XTokenQueue(String data)` Create a new TokenQueue.

方法概要

All Methods Static Methods Instance Methods Concrete Methods
限定符和类型	方法和说明
`void`	`addFirst(Character c)` Add a character to the start of the queue (will be the next character retrieved).
`void`	`addFirst(String seq)` Add a string to the start of the queue.
`void`	`advance()` Drops the next character off the queue.
`String`	`chompBalanced(char open, char close)` Pulls a balanced string off the queue.
`String`	`chompBalancedNotInQuotes(char open, char close)`
`String`	`chompBalancedQuotes()`
`String`	`chompTo(String seq)` Pulls a string off the queue (like consumeTo), and then pulls off the matched string (but does not return it).
`String`	`chompToIgnoreCase(String seq)`
`char`	`consume()` Consume one character off queue.
`void`	`consume(String seq)` Consumes the supplied sequence of the queue.
`String`	`consumeAny(String... seq)`
`String`	`consumeAttributeKey()` Consume an attribute key off the queue (letter, digit, -, _, :")
`String`	`consumeCssIdentifier()` Consume a CSS identifier (ID or class) off the queue (letter, digit, -, _) http://www.w3.org/TR/CSS2/syndata.html#value-def-identifier
`String`	`consumeElementSelector()` Consume a CSS element selector (tag name, but \| instead of : for namespaces, to not conflict with :pseudo selects).
`String`	`consumeTagName()` Consume an tag name off the queue (word or :, _, -)
`String`	`consumeTo(String seq)` Pulls a string off the queue, up to but exclusive of the match sequence, or to the queue running out.
`String`	`consumeToAny(String... seq)` Consumes to the first sequence provided, or to the end of the queue.
`String`	`consumeToIgnoreCase(String seq)`
`String`	`consumeToUnescaped(String str)`
`boolean`	`consumeWhitespace()` Pulls the next run of whitespace characters of the queue.
`String`	`consumeWord()` Retrieves the next run of word type (letter or digit) off the queue.
`boolean`	`containsAny(String... seq)`
`boolean`	`isEmpty()` Is the queue empty?
`boolean`	`matchChomp(String seq)` Tests if the queue matches the sequence (as with match), and if they do, removes the matched string from the queue.
`boolean`	`matches(String seq)` Tests if the next characters on the queue match the sequence.
`boolean`	`matchesAny(char... seq)`
`boolean`	`matchesAny(String... seq)` Tests if the next characters match any of the sequences.
`boolean`	`matchesCS(String seq)` Case sensitive match test.
`boolean`	`matchesRegex(String seq)`
`boolean`	`matchesStartTag()`
`boolean`	`matchesWhitespace()` Tests if queue starts with a whitespace character.
`boolean`	`matchesWord()` Test if the queue matches a word character (letter or digit).
`List<String>`	`parseFuncionParams()`
`static List<String>`	`parseFuncionParams(String paramStr)`
`char`	`peek()` Retrieves but does not remove the first character from the queue.
`String`	`remainder()` Consume and return whatever is left on the queue.
`String`	`toString()`
`static List<String>`	`trimQuotes(List<String> strs)`
`static String`	`trimQuotes(String str)`
`void`	`unConsume(int length)`
`void`	`unConsume(String word)`
`static String`	`unescape(String in)` Unescaped a \ escaped string.

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

- 构造器详细资料
  - XTokenQueue
```
public XTokenQueue(String data)
```
    Create a new TokenQueue.
    
    参数:
    
    data - string of data to back queue.
- 方法详细资料
  - isEmpty
```
public boolean isEmpty()
```
    Is the queue empty?
    
    返回:
    
    true if no data left in queue.
  - peek
```
public char peek()
```
    Retrieves but does not remove the first character from the queue.
    
    返回:
    
    First character, or 0 if empty.
  - addFirst
```
public void addFirst(Character c)
```
    Add a character to the start of the queue (will be the next character retrieved).
    
    参数:
    
    c - character to add
  - addFirst
```
public void addFirst(String seq)
```
    Add a string to the start of the queue.
    
    参数:
    
    seq - string to add.
  - matches
```
public boolean matches(String seq)
```
    Tests if the next characters on the queue match the sequence. Case insensitive.
    
    参数:
    
    seq - String to check queue for.
    
    返回:
    
    true if the next characters match.
  - matchesRegex
```
public boolean matchesRegex(String seq)
```
  - matchesCS
```
public boolean matchesCS(String seq)
```
    Case sensitive match test.
    
    参数:
    
    seq - string to case sensitively check for
    
    返回:
    
    true if matched, false if not
  - matchesAny
```
public boolean matchesAny(String... seq)
```
    Tests if the next characters match any of the sequences. Case insensitive.
    
    参数:
    
    seq - list of strings to case insensitively check for
    
    返回:
    
    true of any matched, false if none did
  - matchesAny
```
public boolean matchesAny(char... seq)
```
  - matchesStartTag
```
public boolean matchesStartTag()
```
  - matchChomp
```
public boolean matchChomp(String seq)
```
    Tests if the queue matches the sequence (as with match), and if they do, removes the matched string from the queue.
    
    参数:
    
    seq - String to search for, and if found, remove from queue.
    
    返回:
    
    true if found and removed, false if not found.
  - matchesWhitespace
```
public boolean matchesWhitespace()
```
    Tests if queue starts with a whitespace character.
    
    返回:
    
    if starts with whitespace
  - matchesWord
```
public boolean matchesWord()
```
    Test if the queue matches a word character (letter or digit).
    
    返回:
    
    if matches a word character
  - advance
```
public void advance()
```
    Drops the next character off the queue.
  - consume
```
public char consume()
```
    Consume one character off queue.
    
    返回:
    
    first character on queue.
  - consume
```
public void consume(String seq)
```
    Consumes the supplied sequence of the queue. If the queue does not start with the supplied sequence, will throw an illegal state exception -- but you should be running match() against that condition.
    Case insensitive.
    
    参数:
    
    seq - sequence to remove from head of queue.
  - consumeTo
```
public String consumeTo(String seq)
```
    Pulls a string off the queue, up to but exclusive of the match sequence, or to the queue running out.
    
    参数:
    
    seq - String to end on (and not include in return, but leave on queue). Case sensitive.
    
    返回:
    
    The matched data consumed from queue.
  - consumeToIgnoreCase
```
public String consumeToIgnoreCase(String seq)
```
  - consumeToAny
```
public String consumeToAny(String... seq)
```
    Consumes to the first sequence provided, or to the end of the queue. Leaves the terminator on the queue.
    
    参数:
    
    seq - any number of terminators to consume to. Case insensitive.
    
    返回:
    
    consumed string
  - consumeAny
```
public String consumeAny(String... seq)
```
  - chompTo
```
public String chompTo(String seq)
```
    Pulls a string off the queue (like consumeTo), and then pulls off the matched string (but does not return it).
    If the queue runs out of characters before finding the seq, will return as much as it can (and queue will go isEmpty() == true).
    
    参数:
    
    seq - String to match up to, and not include in return, and to pull off queue. Case sensitive.
    
    返回:
    
    Data matched from queue.
  - chompToIgnoreCase
```
public String chompToIgnoreCase(String seq)
```
  - chompBalancedQuotes
```
public String chompBalancedQuotes()
```
  - chompBalancedNotInQuotes
```
public String chompBalancedNotInQuotes(char open,
                                       char close)
```
  - chompBalanced
```
public String chompBalanced(char open,
                            char close)
```
    Pulls a balanced string off the queue. E.g. if queue is "(one (two) three) four", (,) will return "one (two) three", and leave " four" on the queue. Unbalanced openers and closers can be escaped (with \). Those escapes will be left in the returned string, which is suitable for regexes (where we need to preserve the escape), but unsuitable for contains text strings; use unescape for that.
    
    参数:
    
    open - opener
    
    close - closer
    
    返回:
    
    data matched from the queue
  - unescape
```
public static String unescape(String in)
```
    Unescaped a \ escaped string.
    
    参数:
    
    in - backslash escaped string
    
    返回:
    
    unescaped string
  - consumeWhitespace
```
public boolean consumeWhitespace()
```
    Pulls the next run of whitespace characters of the queue.
    
    返回:
    
    seen
  - consumeWord
```
public String consumeWord()
```
    Retrieves the next run of word type (letter or digit) off the queue.
    
    返回:
    
    String of word characters from queue, or empty string if none.
  - consumeTagName
```
public String consumeTagName()
```
    Consume an tag name off the queue (word or :, _, -)
    
    返回:
    
    tag name
  - consumeElementSelector
```
public String consumeElementSelector()
```
    Consume a CSS element selector (tag name, but | instead of : for namespaces, to not conflict with :pseudo selects).
    
    返回:
    
    tag name
  - unConsume
```
public void unConsume(int length)
```
  - unConsume
```
public void unConsume(String word)
```
  - consumeCssIdentifier
```
public String consumeCssIdentifier()
```
    Consume a CSS identifier (ID or class) off the queue (letter, digit, -, _) http://www.w3.org/TR/CSS2/syndata.html#value-def-identifier
    
    返回:
    
    identifier
  - consumeAttributeKey
```
public String consumeAttributeKey()
```
    Consume an attribute key off the queue (letter, digit, -, _, :")
    
    返回:
    
    attribute key
  - remainder
```
public String remainder()
```
    Consume and return whatever is left on the queue.
    
    返回:
    
    remained of queue.
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object
  - containsAny
```
public boolean containsAny(String... seq)
```
  - trimQuotes
```
public static String trimQuotes(String str)
```
  - trimQuotes
```
public static List<String> trimQuotes(List<String> strs)
```
  - consumeToUnescaped
```
public String consumeToUnescaped(String str)
```
  - parseFuncionParams
```
public List<String> parseFuncionParams()
```
  - parseFuncionParams
```
public static List<String> parseFuncionParams(String paramStr)
```

类 XTokenQueue

构造器概要

方法概要

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

构造器详细资料

XTokenQueue

方法详细资料

isEmpty

peek

addFirst

addFirst

matches

matchesRegex

matchesCS

matchesAny

matchesAny

matchesStartTag

matchChomp

matchesWhitespace

matchesWord

advance

consume

consume

consumeTo

consumeToIgnoreCase

consumeToAny

consumeAny

chompTo

chompToIgnoreCase

chompBalancedQuotes

chompBalancedNotInQuotes

chompBalanced

unescape

consumeWhitespace

consumeWord

consumeTagName

consumeElementSelector

unConsume

unConsume

consumeCssIdentifier

consumeAttributeKey

remainder

toString

containsAny

trimQuotes

trimQuotes

consumeToUnescaped

parseFuncionParams

parseFuncionParams