speiger.src.collections.longs.utils

Class LongIterators

java.lang.Object

speiger.src.collections.longs.utils.LongIterators

public class LongIterators
extends java.lang.Object

A Helper class for Iterators

Field Summary

Fields

Modifier and Type	Field and Description
static speiger.src.collections.longs.utils.LongIterators.EmptyIterator	EMPTY Empty Iterator Reference

Constructor Summary

Constructors

Constructor and Description
LongIterators()

Method Summary

Modifier and Type	Method and Description
static speiger.src.collections.longs.utils.LongIterators.EmptyIterator	emptyIterator() Returns a Immutable EmptyIterator instance that is automatically casted.
static LongBidirectionalIterator	invert(LongBidirectionalIterator it) Inverter function for Bidirectional Iterators
static LongListIterator	invert(LongListIterator it) Inverter function for List Iterators
static LongBidirectionalIterator	unmodifiable(LongBidirectionalIterator iterator) Returns a Immutable Iterator instance based on the instance given.
static LongIterator	unmodifiable(LongIterator iterator) Returns a Immutable Iterator instance based on the instance given.
static LongListIterator	unmodifiable(LongListIterator iterator) Returns a Immutable ListIterator instance based on the instance given.
static int	unwrap(long[] a, java.util.Iterator<? extends java.lang.Long> i) Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(long[] a, java.util.Iterator<? extends java.lang.Long> i, int offset) Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(long[] a, java.util.Iterator<? extends java.lang.Long> i, int offset, int max) Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(long[] a, LongIterator i) A Primitive iterator variant of the LongIterators unwrap function Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(java.lang.Long[] a, LongIterator i) A Function to convert a Primitive Iterator to a Object array.
static int	unwrap(long[] a, LongIterator i, int offset) A Primitive iterator variant of the LongIterators unwrap function Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(java.lang.Long[] a, LongIterator i, int offset) A Function to convert a Primitive Iterator to a Object array.
static int	unwrap(long[] a, LongIterator i, int offset, int max) A Primitive iterator variant of the LongIterators unwrap function Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(java.lang.Long[] a, LongIterator i, int offset, int max) A Function to convert a Primitive Iterator to a Object array.
static LongIterator	wrap(java.util.Iterator<java.lang.Long> iterator) Helper function to convert a Object Iterator into a Primitive Iterator
static speiger.src.collections.longs.utils.LongIterators.ArrayIterator	wrap(long[] a) Returns a Array Wrapping iterator
static speiger.src.collections.longs.utils.LongIterators.ArrayIterator	wrap(long[] a, int start, int end) Returns a Array Wrapping iterator

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY

public static final speiger.src.collections.longs.utils.LongIterators.EmptyIterator EMPTY

Empty Iterator Reference

Constructor Detail

LongIterators

public LongIterators()

Method Detail

emptyIterator

public static speiger.src.collections.longs.utils.LongIterators.EmptyIterator emptyIterator()

Returns a Immutable EmptyIterator instance that is automatically casted.

Returns:

an empty iterator

invert

public static LongBidirectionalIterator invert(LongBidirectionalIterator it)

Inverter function for Bidirectional Iterators

Parameters:

it - the iterator that should be inverted

Returns:

a Inverted Bidirectional Iterator. If it was inverted then it just gives back the original reference

invert

public static LongListIterator invert(LongListIterator it)

Inverter function for List Iterators

Parameters:

it - the iterator that should be inverted

Returns:

a Inverted List Iterator. If it was inverted then it just gives back the original reference

unmodifiable

public static LongIterator unmodifiable(LongIterator iterator)

Returns a Immutable Iterator instance based on the instance given.

Parameters:

iterator - that should be made immutable/unmodifyable

Returns:

a unmodifiable iterator wrapper. If the Iterator already a unmodifyable wrapper then it just returns itself.

unmodifiable

public static LongBidirectionalIterator unmodifiable(LongBidirectionalIterator iterator)

Returns a Immutable Iterator instance based on the instance given.

Parameters:

iterator - that should be made immutable/unmodifyable

Returns:

a unmodifiable iterator wrapper. If the Iterator already a unmodifyable wrapper then it just returns itself.

unmodifiable

public static LongListIterator unmodifiable(LongListIterator iterator)

Returns a Immutable ListIterator instance based on the instance given.

Parameters:

iterator - that should be made immutable/unmodifyable

Returns:

a unmodifiable listiterator wrapper. If the ListIterator already a unmodifyable wrapper then it just returns itself.

wrap

public static LongIterator wrap(java.util.Iterator<java.lang.Long> iterator)

Helper function to convert a Object Iterator into a Primitive Iterator

Parameters:

iterator - that should be converted to a unboxing iterator

Returns:

a primitive iterator

wrap

public static speiger.src.collections.longs.utils.LongIterators.ArrayIterator wrap(long[] a)

Returns a Array Wrapping iterator

Parameters:

a - the array that should be wrapped

Returns:

a Iterator that is wrapping a array.

wrap

public static speiger.src.collections.longs.utils.LongIterators.ArrayIterator wrap(long[] a,
                                                                                   int start,
                                                                                   int end)

Returns a Array Wrapping iterator

Parameters:

a - the array that should be wrapped.

start - the index to be started from.

end - the index that should be ended.

Returns:

a Iterator that is wrapping a array.

unwrap

public static int unwrap(long[] a,
                         java.util.Iterator<? extends java.lang.Long> i)

Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

Returns:

the amount of elements that were inserted into the array.

unwrap

public static int unwrap(long[] a,
                         java.util.Iterator<? extends java.lang.Long> i,
                         int offset)

Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

offset - the array offset where the start should be

Returns:

the amount of elements that were inserted into the array.

unwrap

public static int unwrap(long[] a,
                         java.util.Iterator<? extends java.lang.Long> i,
                         int offset,
                         int max)

Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

offset - the array offset where the start should be

max - the maximum values that should be extracted from the source

Returns:

the amount of elements that were inserted into the array.

Throws:

java.lang.IllegalStateException - if max is smaller the 0 or if the maximum index is larger then the array

unwrap

public static int unwrap(long[] a,
                         LongIterator i)

A Primitive iterator variant of the LongIterators unwrap function Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

Returns:

the amount of elements that were inserted into the array.

unwrap

public static int unwrap(long[] a,
                         LongIterator i,
                         int offset)

A Primitive iterator variant of the LongIterators unwrap function Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

offset - the array offset where the start should be

Returns:

the amount of elements that were inserted into the array.

unwrap

public static int unwrap(long[] a,
                         LongIterator i,
                         int offset,
                         int max)

A Primitive iterator variant of the LongIterators unwrap function Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

offset - the array offset where the start should be

max - the maximum values that should be extracted from the source

Returns:

the amount of elements that were inserted into the array.

Throws:

java.lang.IllegalStateException - if max is smaller the 0 or if the maximum index is larger then the array

unwrap

public static int unwrap(java.lang.Long[] a,
                         LongIterator i)

A Function to convert a Primitive Iterator to a Object array. Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

Returns:

the amount of elements that were inserted into the array.

unwrap

public static int unwrap(java.lang.Long[] a,
                         LongIterator i,
                         int offset)

A Function to convert a Primitive Iterator to a Object array. Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

offset - the array offset where the start should be

Returns:

the amount of elements that were inserted into the array.

unwrap

public static int unwrap(java.lang.Long[] a,
                         LongIterator i,
                         int offset,
                         int max)

A Function to convert a Primitive Iterator to a Object array. Iterates over a iterator and inserts the values into the array and returns the amount that was inserted

Parameters:

a - where the elements should be inserted

i - the source iterator

offset - the array offset where the start should be

max - the maximum values that should be extracted from the source

Returns:

the amount of elements that were inserted into the array.

Throws:

java.lang.IllegalStateException - if max is smaller the 0 or if the maximum index is larger then the array