abstract class ConjunctionIntervalIterator extends IntervalIterator
Modifier and Type | Field and Description |
---|---|
(package private) DocIdSetIterator |
approximation |
(package private) float |
cost |
(package private) java.util.List<IntervalIterator> |
subIterators |
NO_MORE_INTERVALS
NO_MORE_DOCS
Constructor and Description |
---|
ConjunctionIntervalIterator(java.util.List<IntervalIterator> subIterators) |
Modifier and Type | Method and Description |
---|---|
int |
advance(int target)
Advances to the first beyond the current whose document number is greater
than or equal to target, and returns the document number itself.
|
long |
cost()
Returns the estimated cost of this
DocIdSetIterator . |
int |
docID()
Returns the following:
-1 if DocIdSetIterator.nextDoc() or
DocIdSetIterator.advance(int) were not called yet. |
float |
matchCost()
An indication of the average cost of iterating over all intervals in a document
|
int |
nextDoc()
Advances to the next document in the set and returns the doc it is
currently on, or
DocIdSetIterator.NO_MORE_DOCS if there are no more docs in the
set.NOTE: after the iterator has exhausted you should not call this method, as it may result in unpredicted behavior. |
protected abstract void |
reset() |
end, gaps, nextInterval, start, toString
all, empty, range, slowAdvance
final DocIdSetIterator approximation
final java.util.List<IntervalIterator> subIterators
final float cost
ConjunctionIntervalIterator(java.util.List<IntervalIterator> subIterators)
public int docID()
DocIdSetIterator
-1
if DocIdSetIterator.nextDoc()
or
DocIdSetIterator.advance(int)
were not called yet.
DocIdSetIterator.NO_MORE_DOCS
if the iterator has exhausted.
docID
in class DocIdSetIterator
public int nextDoc() throws java.io.IOException
DocIdSetIterator
DocIdSetIterator.NO_MORE_DOCS
if there are no more docs in the
set.nextDoc
in class DocIdSetIterator
java.io.IOException
public int advance(int target) throws java.io.IOException
DocIdSetIterator
DocIdSetIterator.NO_MORE_DOCS
if target
is greater than the highest document number in the set.
The behavior of this method is undefined when called with
target ≤ current
, or after the iterator has exhausted.
Both cases may result in unpredicted behavior.
When target > current
it behaves as if written:
int advance(int target) { int doc; while ((doc = nextDoc()) < target) { } return doc; }Some implementations are considerably more efficient than that.
NOTE: this method may be called with DocIdSetIterator.NO_MORE_DOCS
for
efficiency by some Scorers. If your implementation cannot efficiently
determine that it should exhaust, it is recommended that you check for that
value in each call to this method.
advance
in class DocIdSetIterator
java.io.IOException
protected abstract void reset() throws java.io.IOException
java.io.IOException
public long cost()
DocIdSetIterator
DocIdSetIterator
.
This is generally an upper bound of the number of documents this iterator might match, but may be a rough heuristic, hardcoded value, or otherwise completely inaccurate.
cost
in class DocIdSetIterator
public final float matchCost()
IntervalIterator
matchCost
in class IntervalIterator
TwoPhaseIterator.matchCost()