Interface IteratorOptions<T>

Remarks

If not specified will scan all of the data.

Remarks

Two effects, both wins for a caller that does not need everything:

• The iterator only materializes the requested features' state onto the context — an excluded feature is never even looked up.
• Cells that exist only through an excluded feature are not visited at all. A fill-only cell does not appear in a features scan that excludes Fill — the render path that only paints content stops receiving cells with nothing to paint.

An empty list is the raw-value fast path — no feature state is resolved at all.

Remarks

Optionally a header axis for skipping case be passed in. An example of this is for sorting where the sort direction (row) skips hidden rows but the column direction does not.

Remarks

If includeEmpty is true this will always return rectangular results. If bounds are provided it will provide empty spaces before and after. If passing a large bound care must be taken.

Remarks

If true any merges that fall outside of the range will be include in the top/left most cell that the merge intersects. Useful for rendering merged cells when the top/left is outside the viewport.

Remarks

This is used to allow for iterators to inject custom references.

• Ignores Features
• These will get available in the ICell.IteratorContext.getInjectedReference.
• Used when wanting to iterate over externally managed references
• NOTE - This is a 2D array.
• NOTE - The iterator treats values as read-only but the visitors may modify the references.

Remarks

This is a performance optimization for hot read paths (e.g. rendering). UNSAFE for consumers that retain the context (or the Entry) past the next next() call - the retained reference will reflect the most recently visited cell, not the one it was captured at. Only enable this when the context is consumed inline within the visitor/loop body (e.g. by calling getCell(), which snapshots the state).