Package com.github.tommyettinger.ds.support.util

Class StridingBooleanIterator

java.lang.Object

com.github.tommyettinger.ds.support.util.StridingBooleanIterator

All Implemented Interfaces:

BooleanIterator, Iterator<Boolean>

public class StridingBooleanIterator
extends Object
implements BooleanIterator

Wraps a BooleanIterator so that it starts at an offset, skipping that many items, then returning items that match a given stride, such as every other item, or every tenth item. If the offset is 0, this will try to return the first item and then any items matching the stride, so if the stride is 2, it will return the first item, skip one item, return the item after that, skip, return, skip, return, etc. This has undefined behavior if any items the BooleanIterator could return are modified during iteration.
You can change the iterator, offset, and stride at once using set(BooleanIterator, int, int), and can also just change the iterator with set(BooleanIterator).

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	available
protected boolean	end
protected int	index
BooleanIterator	iterator
protected boolean	next
protected int	offset
protected int	stride

Constructor Summary

Constructors

Constructor	Description
StridingBooleanIterator()
StridingBooleanIterator(BooleanIterator iterator, int offset, int stride)

Method Summary

Modifier and Type	Method	Description
boolean	hasNext()
boolean	nextBoolean()	Returns the next boolean element in the iteration.
void	remove()	NOTE: this does not change the stride or offset, so the same sequence of values will be returned regardless of if some elements are removed with this method.
void	set(BooleanIterator iterator)
void	set(BooleanIterator iterator, int offset, int stride)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.github.tommyettinger.ds.support.util.BooleanIterator

forEachRemaining, next

Methods inherited from interface java.util.Iterator

forEachRemaining

Field Details

iterator

public BooleanIterator iterator

offset

protected int offset

stride

protected int stride

index

protected int index

end

protected boolean end

available

protected boolean available

next

protected boolean next

Constructor Details

StridingBooleanIterator

public StridingBooleanIterator()

StridingBooleanIterator

public StridingBooleanIterator(BooleanIterator iterator,
 int offset,
 int stride)

Method Details

set

public void set(BooleanIterator iterator,
 int offset,
 int stride)

set

public void set(BooleanIterator iterator)

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<Boolean>

nextBoolean

public boolean nextBoolean()

Description copied from interface: BooleanIterator

Returns the next boolean element in the iteration.

Specified by:

nextBoolean in interface BooleanIterator

Returns:

the next boolean element in the iteration

remove

public void remove()

NOTE: this does not change the stride or offset, so the same sequence of values will be returned regardless of if some elements are removed with this method.

Specified by:

remove in interface Iterator<Boolean>