speiger.src.collections.bytes.utils

Class ByteIterators

java.lang.Object

speiger.src.collections.bytes.utils.ByteIterators

public class ByteIterators
extends java.lang.Object

A Helper class for Iterators

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
ByteIterators()

Method Summary

Modifier and Type	Method and Description
static speiger.src.collections.bytes.utils.ByteIterators.EmptyIterator	emptyIterator() Returns a Immutable EmptyIterator instance that is automatically casted.
static ByteBidirectionalIterator	invert(ByteBidirectionalIterator it) Inverter function for Bidirectional Iterators
static ByteListIterator	invert(ByteListIterator it) Inverter function for List Iterators
static ByteBidirectionalIterator	unmodifiable(ByteBidirectionalIterator iterator) Returns a Immutable Iterator instance based on the instance given.
static ByteIterator	unmodifiable(ByteIterator iterator) Returns a Immutable Iterator instance based on the instance given.
static ByteListIterator	unmodifiable(ByteListIterator iterator) Returns a Immutable ListIterator instance based on the instance given.
static int	unwrap(byte[] a, ByteIterator i) A Primitive iterator variant of the ByteIterators 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.Byte[] a, ByteIterator i) A Function to convert a Primitive Iterator to a Object array.
static int	unwrap(byte[] a, ByteIterator i, int offset) A Primitive iterator variant of the ByteIterators 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.Byte[] a, ByteIterator i, int offset) A Function to convert a Primitive Iterator to a Object array.
static int	unwrap(byte[] a, ByteIterator i, int offset, int max) A Primitive iterator variant of the ByteIterators 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.Byte[] a, ByteIterator i, int offset, int max) A Function to convert a Primitive Iterator to a Object array.
static int	unwrap(byte[] a, java.util.Iterator<? extends java.lang.Byte> i) Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(byte[] a, java.util.Iterator<? extends java.lang.Byte> i, int offset) Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static int	unwrap(byte[] a, java.util.Iterator<? extends java.lang.Byte> i, int offset, int max) Iterates over a iterator and inserts the values into the array and returns the amount that was inserted
static speiger.src.collections.bytes.utils.ByteIterators.ArrayIterator	wrap(byte[] a) Returns a Array Wrapping iterator
static speiger.src.collections.bytes.utils.ByteIterators.ArrayIterator	wrap(byte[] a, int start, int end) Returns a Array Wrapping iterator
static ByteIterator	wrap(java.util.Iterator<java.lang.Byte> iterator) Helper function to convert a Object Iterator into a Primitive 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.bytes.utils.ByteIterators.EmptyIterator EMPTY

Empty Iterator Reference

Constructor Detail

ByteIterators

public ByteIterators()

Method Detail

emptyIterator

public static speiger.src.collections.bytes.utils.ByteIterators.EmptyIterator emptyIterator()

Returns a Immutable EmptyIterator instance that is automatically casted.

Returns:

an empty iterator

invert

public static ByteBidirectionalIterator invert(ByteBidirectionalIterator 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 ByteListIterator invert(ByteListIterator 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 ByteIterator unmodifiable(ByteIterator 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 ByteBidirectionalIterator unmodifiable(ByteBidirectionalIterator 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 ByteListIterator unmodifiable(ByteListIterator 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 ByteIterator wrap(java.util.Iterator<java.lang.Byte> 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.bytes.utils.ByteIterators.ArrayIterator wrap(byte[] 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.bytes.utils.ByteIterators.ArrayIterator wrap(byte[] 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(byte[] a,
                         java.util.Iterator<? extends java.lang.Byte> 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(byte[] a,
                         java.util.Iterator<? extends java.lang.Byte> 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(byte[] a,
                         java.util.Iterator<? extends java.lang.Byte> 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(byte[] a,
                         ByteIterator i)

A Primitive iterator variant of the ByteIterators 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(byte[] a,
                         ByteIterator i,
                         int offset)

A Primitive iterator variant of the ByteIterators 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(byte[] a,
                         ByteIterator i,
                         int offset,
                         int max)

A Primitive iterator variant of the ByteIterators 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.Byte[] a,
                         ByteIterator 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.Byte[] a,
                         ByteIterator 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.Byte[] a,
                         ByteIterator 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