BytesRefIterator (Jackrabbit Oak 1.88.0 API)

All Known Implementing Classes:

FilterAtomicReader.FilterTermsEnum, FilteredTermsEnum, FuzzyTermsEnum, MultiTermsEnum, PrefixTermsEnum, SingleTermsEnum, TermRangeTermsEnum, TermsEnum
```
public interface BytesRefIterator
```
A simple iterator interface for BytesRef iteration.

Field Summary

Fields
Modifier and Type Field Description

static BytesRefIterator EMPTY
Singleton BytesRefIterator that iterates over 0 BytesRefs.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`Comparator<BytesRef>`	`getComparator()`	Return the `BytesRef` Comparator used to sort terms provided by the iterator.
`BytesRef`	`next()`	Increments the iteration to the next `BytesRef` in the iterator.

- Field Detail
  - EMPTY
```
static final BytesRefIterator EMPTY
```
    Singleton BytesRefIterator that iterates over 0 BytesRefs.
- Method Detail
  - next
```
BytesRef next()
       throws IOException
```
    Increments the iteration to the next BytesRef in the iterator. Returns the resulting BytesRef or null if the end of the iterator is reached. The returned BytesRef may be re-used across calls to next. After this method returns null, do not call it again: the results are undefined.
    
    Returns:
    
    the next BytesRef in the iterator or null if the end of the iterator is reached.
    
    Throws:
    
    IOException - If there is a low-level I/O error.
  - getComparator
```
Comparator<BytesRef> getComparator()
```
    Return the BytesRef Comparator used to sort terms provided by the iterator. This may return null if there are no items or the iterator is not sorted. Callers may invoke this method many times, so it's best to cache a single instance & reuse it.