public class

Difference

extends Parser<T>

java.lang.Object
↳	com.google.gdata.util.parser.Parser<T>
	↳	com.google.gdata.util.parser.Difference<T>

Class Overview

The Difference parser matches the prefix of the parse buffer if the left parser matches and the right parser does not. The following is a complicated way of constructing a parser which matches a digit: Parser p = Parser.difference(Chset.ALNUM, Chset.ALPHA); p.parse("0") -> matches "0" p.parse("a") -> no match

Summary

[Expand]

Inherited Constants

From class com.google.gdata.util.parser.Parser

Fields
private Parser<? super T>	left
private Parser<? super T>	right

Public Constructors
	Difference(Parser<? super T> left, Parser<? super T> right) Class constructor.

Public Methods
int	parse(char[] buf, int start, int end, T data) Matches the prefix of the buffer (`buf[start,end)`) being parsed if, and only if, the `left` sub-parser matches the incoming state of the buffer and the `right` sub-parser does not match the incoming state of the parse buffer.

[Expand]

Inherited Methods

From class com.google.gdata.util.parser.Parser

final <U extends T> Parser<U>	action(Callback<U> callback) Creates a `Action` that will fire and call `Callback.handle` whenever `this` matches.
static <T> Parser<T>	alternative(Parser<? super T> left, Parser<? super T> right) Creates an `Alternative` parser from the `left` and `right` sub-parsers.
static <T> Parser<T>	difference(Parser<? super T> left, Parser<? super T> right) Creates a `Difference` parser from the `left` and `right` sub-parsers.
static <T> Parser<T>	intersection(Parser<? super T> left, Parser<? super T> right) Creates an `Intersection` parser from the `left` and `right` sub-parsers.
final Parser<T>	list(Parser<? super T> sep) Creates a `Parser` that matches a sequence of `this` parsers separated by `sep` parsers.
final Parser<T>	optional() Creates a `Repeat` parser that matches `this` either 0 or 1 times.
final int	parse(String str, T udata) Convenience routine to parse a string.
abstract int	parse(char[] buf, int start, int end, T udata) The parse interface that subclasses must implement.
final int	parse(Reader reader, T udata) Convenience routine to parse a `java.io.Reader`.
final int	parse(char[] buf, T udata) Convenience routine to parse a character array.
final Parser<T>	plus() Creates a `Repeat` parser that matches `this` 1 or more times.
final Parser<T>	repeat(int min, int max) Creates a `Repeat` parser that matches `this` at least `min` times and not mroe than `max` times.
final Parser<T>	repeat(int count) Creates a `Repeat` parser that matches `this` exactly `count` times.
static <T> Parser<T>	sequence(Parser<? super T> one, Parser<? super T> two, Parser<? super T> three, Parser<? super T> four) Creates a sequence of four parsers.
static <T> Parser<T>	sequence(Parser<? super T> one, Parser<? super T> two, Parser<? super T> three, Parser<? super T> four, Parser<? super T> five) Creates a sequence of five parsers.
static <T> Parser<T>	sequence(Parser<? super T> one, Parser<? super T> two, Parser<? super T> three) Creates a `Sequence` parser from parsers `one`, `two` and `three` sub-parsers.
static <T> Parser<T>	sequence(Parser<? super T> left, Parser<? super T> right) Creates a `Sequence` parser from the `left` and `right` sub-parsers.
final Parser<T>	star() Creates a `Repeat` parser that matches `this` 0 or more times.

From class java.lang.Object

Fields

private Parser<? super T> left

private Parser<? super T> right

Public Constructors

public Difference (Parser<? super T> left, Parser<? super T> right)

Class constructor.

Parameters

left	The `Parser` that must match against the parse buffer.
right	The `Parser` that must not match against the parse buffer.

Public Methods

public int parse (char[] buf, int start, int end, T data)

Matches the prefix of the buffer (buf[start,end)) being parsed if, and only if, the left sub-parser matches the incoming state of the buffer and the right sub-parser does not match the incoming state of the parse buffer. It does not make much sense to specify a right sub-parser that matches the empty string as doing so will cause this function to always return NO_MATCH.

Parameters

buf	The character array to match against.
start	The start offset of data within the character array to match against.
end	The end offset of data within the character array to match against.
data	User defined object that is passed to `Callback.handle` when an `Action` fires.

Interfaces

Classes

Difference

Class Overview

See Also

Summary

Fields

private Parser<? super T> left

private Parser<? super T> right

Public Constructors

public Difference (Parser<? super T> left, Parser<? super T> right)

Parameters

Public Methods

public int parse (char[] buf, int start, int end, T data)

Parameters

See Also