ariba.util.core
Class SubsetIterator

java.lang.Object
  ariba.util.core.SubsetIterator

All Implemented Interfaces:

Iterator

public final class SubsetIterator
extends Object
implements Iterator

A SubsetIterator produces a series of subsets of the requested size from a source array of objects.

Constructor Summary

SubsetIterator(Object[] source, int subsetSize)
Creates a new SubsetIterator for the given source array, where each subset will be of the given subsetSize.

SubsetIterator(Object[] source, int subsetSize, Object[] result)
Creates a new SubsetIterator for the given source array, where each subset will be of the given subsetSize.

Method Summary

boolean	hasNext() Returns true if the SubsetIterator has more elements.
static void	main(String[] args) The first argument is assumed to be an integer which is the requested subset size.
Object	next() Returns the next element of this SubsetIterator as an array of Objects.
void	remove()

Methods inherited from class java.lang.Object

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

Constructor Detail

SubsetIterator

public SubsetIterator(Object[] source,
                      int subsetSize)

Creates a new SubsetIterator for the given source array, where each subset will be of the given subsetSize.

SubsetIterator

public SubsetIterator(Object[] source,
                      int subsetSize,
                      Object[] result)

Creates a new SubsetIterator for the given source array, where each subset will be of the given subsetSize. The caller provides the result array which will be returned in each successful call to next().

Method Detail

hasNext

public boolean hasNext()

Returns true if the SubsetIterator has more elements.

Specified by:

hasNext in interface Iterator

next

public Object next()

Returns the next element of this SubsetIterator as an array of Objects. Throws a NoSuchElementException if there is no next elemement, i.e. if hasNext() returned false.

Specified by:

next in interface Iterator

remove

public void remove()

Specified by:

remove in interface Iterator

main

public static void main(String[] args)

The first argument is assumed to be an integer which is the requested subset size. The remaining arguments are used as the elements of the full set.