speiger.src.collections.doubles.lists

Class ImmutableDoubleList

java.lang.Object

java.util.AbstractCollection<java.lang.Double>

speiger.src.collections.doubles.collections.AbstractDoubleCollection

speiger.src.collections.doubles.lists.AbstractDoubleList

speiger.src.collections.doubles.lists.ImmutableDoubleList

All Implemented Interfaces:

java.lang.Iterable<java.lang.Double>, java.util.Collection<java.lang.Double>, java.util.List<java.lang.Double>, DoubleCollection, DoubleIterable, DoubleList

public class ImmutableDoubleList
extends AbstractDoubleList

A Type-Specific Immutable implementation of list that is written to reduce (un)boxing

Constructor Summary

Constructors

Constructor and Description
ImmutableDoubleList(java.util.Collection<? extends java.lang.Double> c) Deprecated.
ImmutableDoubleList(double... a) Creates a new Immutable copy of the contents of the Array.
ImmutableDoubleList(double[] a, int length) Creates a new ImmutableList copy of the array with a custom length
ImmutableDoubleList(double[] a, int offset, int length) Creates a new ImmutableList copy of the array with in the custom range.
ImmutableDoubleList(DoubleCollection c) Creates a new Immutable copy of the contents of the Collection.
ImmutableDoubleList(DoubleList l) Creates a new Immutable copy of the contents of the List.

Method Summary

Modifier and Type	Method and Description
boolean	add(double e) A Type-Specific implementation of add function that delegates to List.add(int, Object)
void	add(int index, double e) A Type-Specific add Function to reduce (un)boxing
boolean	addAll(double[] e, int offset, int length) A Type-Specific Array based addAll method to reduce the amount of Wrapping
boolean	addAll(int index, java.util.Collection<? extends java.lang.Double> c) Deprecated.
boolean	addAll(int index, DoubleCollection c) A Type-Specific addAll Function to reduce (un)boxing
boolean	addAll(int index, DoubleList c) A Type-Specific and optimized addAll function that allows a faster transfer of elements
void	addElements(int from, double[] a, int offset, int length) A function to fast add elements to the list
void	clear()
boolean	contains(double e) A Type Specific implementation of the Collection#contains function.
boolean	contains(java.lang.Object o) Deprecated.
ImmutableDoubleList	copy() A Function that does a shallow clone of the Collection itself.
int	count(Double2BooleanFunction filter) Helper function to reduce stream usage that allows to count the valid elements.
double[]	extractElements(int from, int to) A function to fast extract elements out of the list, this removes the elements that were fetched.
double	findFirst(Double2BooleanFunction filter) Helper function to reduce stream usage that allows to filter for the first match.
void	forEach(DoubleConsumer action) A Type Specific foreach function that reduces (un)boxing
<E> void	forEach(E input, ObjectDoubleConsumer<E> action) Helper function to reduce Lambda usage and allow for more method references, since these are faster/cleaner.
double	getDouble(int index) A Type-Specific get function to reduce (un)boxing
double[]	getElements(int from, double[] a, int offset, int length) A function to fast fetch elements from the list
int	indexOf(double e) A Type-Specific function to find the index of a given element
int	indexOf(java.lang.Object o) Deprecated.
int	lastIndexOf(double e) A Type-Specific function to find the last index of a given element
int	lastIndexOf(java.lang.Object o) Deprecated.
DoubleListIterator	listIterator(int index) A Type-Specific Iterator of listIterator
boolean	matchesAll(Double2BooleanFunction filter) Helper function to reduce stream usage that allows to filter for all matches.
boolean	matchesAny(Double2BooleanFunction filter) Helper function to reduce stream usage that allows to filter for any matches.
boolean	matchesNone(Double2BooleanFunction filter) Helper function to reduce stream usage that allows to filter for no matches.
java.util.stream.DoubleStream	primitiveStream() Returns a Java-Type-Specific Stream to reduce boxing/unboxing.
double	reduce(double identity, DoubleDoubleUnaryOperator operator) Performs a reduction on the elements of this Iterable
double	reduce(DoubleDoubleUnaryOperator operator) Performs a reduction on the elements of this Iterable
boolean	remDouble(double type) A Type-Specific implementation of remove.
boolean	remIf(java.util.function.DoublePredicate filter) A Type-Specific removeIf function to reduce (un)boxing.
boolean	removeAll(java.util.Collection<?> c) Deprecated.
boolean	removeAll(DoubleCollection c) A Type-Specific implementation of removeAll.
boolean	removeAll(DoubleCollection c, DoubleConsumer r) A Type-Specific removeAll function that reduces (un)boxing.
double	removeDouble(int index) A Type-Specific remove function to reduce (un)boxing
void	removeElements(int from, int to) a function to fast remove elements from the list.
boolean	removeIf(java.util.function.Predicate<? super java.lang.Double> filter) Deprecated.
void	replaceAll(java.util.function.UnaryOperator<java.lang.Double> o) Deprecated.
void	replaceDoubles(java.util.function.DoubleUnaryOperator o) A Type-Specific replace function to reduce (un)boxing
boolean	retainAll(java.util.Collection<?> c) Deprecated.
boolean	retainAll(DoubleCollection c) A Type-Specific implementation of retainAll.
boolean	retainAll(DoubleCollection c, DoubleConsumer r) A Type-Specific retainAll function that reduces (un)boxing.
double	set(int index, double e) A Type-Specific set function to reduce (un)boxing
int	size() A function to return the size of the list
void	size(int size) A function to ensure the elements are within the requested size.
void	sort(DoubleComparator c) Sorts the elements specified by the Natural order either by using the Comparator or the elements
DoubleSplititerator	spliterator() A Type Specific Type Splititerator to reduce boxing/unboxing
double	swapRemove(int index) A Highly Optimized remove function that removes the desired element.
java.lang.Object[]	toArray() Deprecated.
<E> E[]	toArray(E[] a) Deprecated.
double[]	toDoubleArray(double[] a) A Type-Specific implementation of toArray.
void	unstableSort(DoubleComparator c) Sorts the elements specified by the Natural order either by using the Comparator or the elements using a unstable sort

Methods inherited from class speiger.src.collections.doubles.lists.AbstractDoubleList

add, addAll, addAll, addAll, equals, hashCode, iterator, listIterator, subList, swapRemoveDouble

Methods inherited from class speiger.src.collections.doubles.collections.AbstractDoubleCollection

add, containsAll, containsAll, containsAny, containsAny, remove, toDoubleArray

Methods inherited from class java.util.AbstractCollection

isEmpty, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface speiger.src.collections.doubles.lists.DoubleList

add, addElements, addElements, addIfAbsent, addIfPresent, fillBuffer, get, getElements, remove, remove, set, sort, synchronize, synchronize, unmodifiable, unstableSort

Methods inherited from interface speiger.src.collections.doubles.collections.DoubleCollection

addAll, addAll, containsAll, containsAny, containsAny, parallelPrimitiveStream, pour, toDoubleArray

Methods inherited from interface speiger.src.collections.doubles.collections.DoubleIterable

arrayflatMap, asAsync, distinct, filter, flatMap, forEach, limit, map, peek, pourAsList, pourAsSet, sorted

Methods inherited from interface java.util.List

containsAll, isEmpty

Methods inherited from interface java.util.Collection

parallelStream, stream

Constructor Detail

ImmutableDoubleList

@Deprecated
public ImmutableDoubleList(java.util.Collection<? extends java.lang.Double> c)

Deprecated.

Creates a new Immutable copy of the contents of the Collection.

Parameters:

c - the elements that should be added into the list

ImmutableDoubleList

public ImmutableDoubleList(DoubleCollection c)

Creates a new Immutable copy of the contents of the Collection.

Parameters:

c - the elements that should be added into the list

ImmutableDoubleList

public ImmutableDoubleList(DoubleList l)

Creates a new Immutable copy of the contents of the List.

Parameters:

l - the elements that should be added into the list

ImmutableDoubleList

public ImmutableDoubleList(double... a)

Creates a new Immutable copy of the contents of the Array.

Parameters:

a - the array that should be copied

ImmutableDoubleList

public ImmutableDoubleList(double[] a,
                           int length)

Creates a new ImmutableList copy of the array with a custom length

Parameters:

a - the array that should be copied

length - the desired length that should be copied

ImmutableDoubleList

public ImmutableDoubleList(double[] a,
                           int offset,
                           int length)

Creates a new ImmutableList copy of the array with in the custom range.

Parameters:

a - the array that should be copied

offset - the starting offset of where the array should be copied from

length - the desired length that should be copied

Throws:

java.lang.IllegalStateException - if offset is smaller then 0

java.lang.IllegalStateException - if the offset + length exceeds the array length

Method Detail

add

public boolean add(double e)

Description copied from class: AbstractDoubleList

A Type-Specific implementation of add function that delegates to List.add(int, Object)

Specified by:

add in interface DoubleCollection

Specified by:

add in interface DoubleList

Overrides:

add in class AbstractDoubleList

Parameters:

e - the element to add

Returns:

true if the list was modified

See Also:

List.add(Object)

add

public void add(int index,
                double e)

Description copied from interface: DoubleList

A Type-Specific add Function to reduce (un)boxing

Parameters:

index - index at which the specified element is to be inserted

e - the element to add

See Also:

List.add(int, Object)

addAll

@Deprecated
public boolean addAll(int index,
                                   java.util.Collection<? extends java.lang.Double> c)

Deprecated.

addAll

public boolean addAll(int index,
                      DoubleCollection c)

Description copied from interface: DoubleList

A Type-Specific addAll Function to reduce (un)boxing

Parameters:

index - index at which the specified elements is to be inserted

c - the elements that need to be added

Returns:

true if the list was modified

See Also:

List.addAll(int, java.util.Collection)

addAll

public boolean addAll(int index,
                      DoubleList c)

Description copied from interface: DoubleList

A Type-Specific and optimized addAll function that allows a faster transfer of elements

Parameters:

index - index at which the specified elements is to be inserted

c - the elements that need to be added

Returns:

true if the list was modified

addAll

public boolean addAll(double[] e,
                      int offset,
                      int length)

Description copied from interface: DoubleCollection

A Type-Specific Array based addAll method to reduce the amount of Wrapping

Parameters:

e - the elements that should be added

offset - where to start within the array

length - how many elements of the array should be added

Returns:

if the collection was modified

addElements

public void addElements(int from,
                        double[] a,
                        int offset,
                        int length)

Description copied from interface: DoubleList

A function to fast add elements to the list

Parameters:

from - the index where the elements should be added into the list

a - the elements that should be added

offset - the start index of the array should be read from

length - how many elements should be read from

getElements

public double[] getElements(int from,
                            double[] a,
                            int offset,
                            int length)

Description copied from interface: DoubleList

A function to fast fetch elements from the list

Parameters:

from - index where the list should be fetching elements from

a - the array where the values should be inserted to

offset - the startIndex of where the array should be written to

length - the number of elements the values should be fetched from

Returns:

the inputArray

removeElements

public void removeElements(int from,
                           int to)

Description copied from interface: DoubleList

a function to fast remove elements from the list.

Parameters:

from - the start index of where the elements should be removed from (inclusive)

to - the end index of where the elements should be removed to (exclusive)

extractElements

public double[] extractElements(int from,
                                int to)

Description copied from interface: DoubleList

A function to fast extract elements out of the list, this removes the elements that were fetched.

Parameters:

from - the start index of where the elements should be fetched from (inclusive)

to - the end index of where the elements should be fetched to (exclusive)

Returns:

a array of the elements that were fetched

contains

@Deprecated
public boolean contains(java.lang.Object o)

Deprecated.

A function to find if the Element is present in this list.

Specified by:

contains in interface java.util.Collection<java.lang.Double>

Specified by:

contains in interface java.util.List<java.lang.Double>

Specified by:

contains in interface DoubleCollection

Specified by:

contains in interface DoubleList

Overrides:

contains in class AbstractDoubleCollection

Parameters:

o - the element that is searched for

Returns:

if the element was found.

indexOf

@Deprecated
public int indexOf(java.lang.Object o)

Deprecated.

A function to find the index of a given element

Specified by:

indexOf in interface java.util.List<java.lang.Double>

Specified by:

indexOf in interface DoubleList

Overrides:

indexOf in class AbstractDoubleList

Parameters:

o - the element that is searched for

Returns:

the index of the element if found. (if not found then -1)

lastIndexOf

@Deprecated
public int lastIndexOf(java.lang.Object o)

Deprecated.

A function to find the last index of a given element

Specified by:

lastIndexOf in interface java.util.List<java.lang.Double>

Specified by:

lastIndexOf in interface DoubleList

Overrides:

lastIndexOf in class AbstractDoubleList

Parameters:

o - the element that is searched for

Returns:

the last index of the element if found. (if not found then -1)

contains

public boolean contains(double e)

A Type Specific implementation of the Collection#contains function.

Specified by:

contains in interface DoubleCollection

Overrides:

contains in class AbstractDoubleCollection

Parameters:

e - the element that is searched for.

Returns:

if the element was found

indexOf

public int indexOf(double e)

A Type-Specific function to find the index of a given element

Specified by:

indexOf in interface DoubleList

Overrides:

indexOf in class AbstractDoubleList

Parameters:

e - the element that is searched for

Returns:

the index of the element if found. (if not found then -1)

lastIndexOf

public int lastIndexOf(double e)

A Type-Specific function to find the last index of a given element

Specified by:

lastIndexOf in interface DoubleList

Overrides:

lastIndexOf in class AbstractDoubleList

Parameters:

e - the element that is searched for

Returns:

the last index of the element if found. (if not found then -1)

sort

public void sort(DoubleComparator c)

Description copied from interface: DoubleList

Sorts the elements specified by the Natural order either by using the Comparator or the elements

Parameters:

c - the sorter of the elements, can be null

See Also:

List.sort(Comparator), DoubleArrays.stableSort(double[], DoubleComparator)

unstableSort

public void unstableSort(DoubleComparator c)

Description copied from interface: DoubleList

Sorts the elements specified by the Natural order either by using the Comparator or the elements using a unstable sort

Parameters:

c - the sorter of the elements, can be null

See Also:

List.sort(Comparator), DoubleArrays.unstableSort(double[], DoubleComparator)

getDouble

public double getDouble(int index)

A Type-Specific get function to reduce (un)boxing

Parameters:

index - the index of the element to fetch

Returns:

the value of the requested index

Throws:

java.lang.IndexOutOfBoundsException - if the index is out of range

See Also:

List.get(int)

copy

public ImmutableDoubleList copy()

Description copied from interface: DoubleCollection

A Function that does a shallow clone of the Collection itself. This function is more optimized then a copy constructor since the Collection does not have to be unsorted/resorted. It can be compared to Cloneable but with less exception risk

Specified by:

copy in interface DoubleCollection

Specified by:

copy in interface DoubleList

Overrides:

copy in class AbstractDoubleList

Returns:

a Shallow Copy of the collection

forEach

public void forEach(DoubleConsumer action)

A Type Specific foreach function that reduces (un)boxing

Parameters:

action - The action to be performed for each element

Throws:

java.lang.NullPointerException - if the specified action is null

See Also:

Iterable.forEach(java.util.function.Consumer)

ImplSpec:

The default implementation behaves as if:

 	for(int i = 0;i<size;i++)
 		action.accept(data[i]);
 

forEach

public <E> void forEach(E input,
                        ObjectDoubleConsumer<E> action)

Description copied from interface: DoubleIterable

Helper function to reduce Lambda usage and allow for more method references, since these are faster/cleaner.

Type Parameters:

E - the generic type of the Object

Parameters:

input - the object that should be included

action - The action to be performed for each element

matchesAny

public boolean matchesAny(Double2BooleanFunction filter)

Description copied from interface: DoubleIterable

Helper function to reduce stream usage that allows to filter for any matches.

Parameters:

filter - that should be applied

Returns:

true if any matches were found

matchesNone

public boolean matchesNone(Double2BooleanFunction filter)

Description copied from interface: DoubleIterable

Helper function to reduce stream usage that allows to filter for no matches.

Parameters:

filter - that should be applied

Returns:

true if no matches were found

matchesAll

public boolean matchesAll(Double2BooleanFunction filter)

Description copied from interface: DoubleIterable

Helper function to reduce stream usage that allows to filter for all matches.

Parameters:

filter - that should be applied

Returns:

true if all matches.

findFirst

public double findFirst(Double2BooleanFunction filter)

Description copied from interface: DoubleIterable

Helper function to reduce stream usage that allows to filter for the first match.

Parameters:

filter - that should be applied

Returns:

the found value or the null equivalent variant.

reduce

public double reduce(double identity,
                     DoubleDoubleUnaryOperator operator)

Description copied from interface: DoubleIterable

Performs a reduction on the elements of this Iterable

Parameters:

identity - the start value

operator - the operation that should be applied

Returns:

the reduction result, returns identity if nothing was found

reduce

public double reduce(DoubleDoubleUnaryOperator operator)

Description copied from interface: DoubleIterable

Performs a reduction on the elements of this Iterable

Parameters:

operator - the operation that should be applied

Returns:

the reduction result, returns null value if nothing was found

count

public int count(Double2BooleanFunction filter)

Description copied from interface: DoubleIterable

Helper function to reduce stream usage that allows to count the valid elements.

Parameters:

filter - that should be applied

Returns:

the amount of Valid Elements

listIterator

public DoubleListIterator listIterator(int index)

Description copied from interface: DoubleList

A Type-Specific Iterator of listIterator

Specified by:

listIterator in interface java.util.List<java.lang.Double>

Specified by:

listIterator in interface DoubleList

Overrides:

listIterator in class AbstractDoubleList

See Also:

List.listIterator(int)

set

public double set(int index,
                  double e)

Description copied from interface: DoubleList

A Type-Specific set function to reduce (un)boxing

Parameters:

index - index of the element to replace

e - element to be stored at the specified position

Returns:

the element previously at the specified position

See Also:

List.set(int, Object)

replaceAll

@Deprecated
public void replaceAll(java.util.function.UnaryOperator<java.lang.Double> o)

Deprecated.

Description copied from interface: DoubleList

This default implementation delegates to the corresponding type-specific function.

replaceDoubles

public void replaceDoubles(java.util.function.DoubleUnaryOperator o)

Description copied from interface: DoubleList

A Type-Specific replace function to reduce (un)boxing

Parameters:

o - the action to replace the values

removeDouble

public double removeDouble(int index)

Description copied from interface: DoubleList

A Type-Specific remove function to reduce (un)boxing

Parameters:

index - the index of the element to be removed

Returns:

the element previously at the specified position

See Also:

List.remove(int)

swapRemove

public double swapRemove(int index)

Description copied from interface: DoubleList

A Highly Optimized remove function that removes the desired element. But instead of shifting the elements to the left it moves the last element to the removed space.

Parameters:

index - the index of the element to be removed

Returns:

the element previously at the specified position

remDouble

public boolean remDouble(double type)

Description copied from class: AbstractDoubleCollection

A Type-Specific implementation of remove. This implementation iterates over the elements until it finds the element that is searched for or it runs out of elements. It stops after finding the first element

Specified by:

remDouble in interface DoubleCollection

Overrides:

remDouble in class AbstractDoubleCollection

Parameters:

type - the element that is searched for

Returns:

true if the element was found and removed.

See Also:

Collection.remove(Object)

removeAll

@Deprecated
public boolean removeAll(java.util.Collection<?> c)

Deprecated.

Specified by:

removeAll in interface java.util.Collection<java.lang.Double>

Specified by:

removeAll in interface java.util.List<java.lang.Double>

Overrides:

removeAll in class java.util.AbstractCollection<java.lang.Double>

retainAll

@Deprecated
public boolean retainAll(java.util.Collection<?> c)

Deprecated.

Specified by:

retainAll in interface java.util.Collection<java.lang.Double>

Specified by:

retainAll in interface java.util.List<java.lang.Double>

Overrides:

retainAll in class java.util.AbstractCollection<java.lang.Double>

removeIf

@Deprecated
public boolean removeIf(java.util.function.Predicate<? super java.lang.Double> filter)

Deprecated.

Description copied from interface: DoubleCollection

This default implementation delegates to the corresponding type-specific function.

removeAll

public boolean removeAll(DoubleCollection c)

Description copied from class: AbstractDoubleCollection

A Type-Specific implementation of removeAll. This Implementation iterates over all elements and removes them as they were found in the other collection.

Specified by:

removeAll in interface DoubleCollection

Overrides:

removeAll in class AbstractDoubleCollection

Parameters:

c - the elements that should be deleted

Returns:

true if the collection was modified.

See Also:

Collection.removeAll(Collection)

retainAll

public boolean retainAll(DoubleCollection c)

Description copied from class: AbstractDoubleCollection

A Type-Specific implementation of retainAll. This Implementation iterates over all elements and removes them as they were not found in the other collection.

Specified by:

retainAll in interface DoubleCollection

Overrides:

retainAll in class AbstractDoubleCollection

Parameters:

c - the elements that should be kept

Returns:

true if the collection was modified.

See Also:

Collection.retainAll(Collection)

removeAll

public boolean removeAll(DoubleCollection c,
                         DoubleConsumer r)

Description copied from interface: DoubleCollection

A Type-Specific removeAll function that reduces (un)boxing. It also notifies the remover of which exact element is going to be removed.

Specified by:

removeAll in interface DoubleCollection

Overrides:

removeAll in class AbstractDoubleCollection

Parameters:

c - the collection of elements that should be removed

r - elements that got removed

Returns:

true if any element was removed

See Also:

Collection.removeAll(Collection)

retainAll

public boolean retainAll(DoubleCollection c,
                         DoubleConsumer r)

Description copied from interface: DoubleCollection

A Type-Specific retainAll function that reduces (un)boxing. It also notifies the remover of which exact element is going to be removed.

Specified by:

retainAll in interface DoubleCollection

Overrides:

retainAll in class AbstractDoubleCollection

Parameters:

c - the collection of elements that should be kept

r - elements that got removed

Returns:

true if any element was removed

See Also:

Collection.retainAll(Collection)

remIf

public boolean remIf(java.util.function.DoublePredicate filter)

Description copied from interface: DoubleCollection

A Type-Specific removeIf function to reduce (un)boxing.

Removes elements that were selected by the filter

Parameters:

filter - Filters the elements that should be removed

Returns:

true if the collection was modified

See Also:

Collection.removeIf(Predicate)

toArray

@Deprecated
public java.lang.Object[] toArray()

Deprecated.

A toArray implementation that ensures the Array itself is a Object.

Specified by:

toArray in interface java.util.Collection<java.lang.Double>

Specified by:

toArray in interface java.util.List<java.lang.Double>

Overrides:

toArray in class java.util.AbstractCollection<java.lang.Double>

Returns:

a Array of the elements in the list

toArray

@Deprecated
public <E> E[] toArray(E[] a)

Deprecated.

A toArray implementation that ensures the Array itself is a Object.

Specified by:

toArray in interface java.util.Collection<java.lang.Double>

Specified by:

toArray in interface java.util.List<java.lang.Double>

Overrides:

toArray in class java.util.AbstractCollection<java.lang.Double>

Parameters:

a - original array. If null a Object array with the right size is created. If to small the Array of the same type is created with the right size

Returns:

a Array of the elements in the list

toDoubleArray

public double[] toDoubleArray(double[] a)

Description copied from class: AbstractDoubleCollection

A Type-Specific implementation of toArray. This implementation iterates over all elements and unwraps them into primitive type.

Specified by:

toDoubleArray in interface DoubleCollection

Overrides:

toDoubleArray in class AbstractDoubleCollection

Parameters:

a - array that the elements should be injected to. If null or to small a new array with the right size is created

Returns:

an array containing all of the elements in this collection

See Also:

Collection.toArray(Object[])

size

public int size()

A function to return the size of the list

Specified by:

size in interface java.util.Collection<java.lang.Double>

Specified by:

size in interface java.util.List<java.lang.Double>

Specified by:

size in class java.util.AbstractCollection<java.lang.Double>

Returns:

the size of elements in the list

size

public void size(int size)

Description copied from interface: DoubleList

A function to ensure the elements are within the requested size. If smaller then the stored elements they get removed as needed. If bigger it is ensured that enough room is provided depending on the implementation

Specified by:

size in interface DoubleList

Overrides:

size in class AbstractDoubleList

Parameters:

size - the requested amount of elements/room for elements

clear

public void clear()

Specified by:

clear in interface java.util.Collection<java.lang.Double>

Specified by:

clear in interface java.util.List<java.lang.Double>

Overrides:

clear in class java.util.AbstractCollection<java.lang.Double>

primitiveStream

public java.util.stream.DoubleStream primitiveStream()

Returns a Java-Type-Specific Stream to reduce boxing/unboxing.

Returns:

a Stream of the closest java type

Note:

characteristics are ordered, sized, subsized

spliterator

public DoubleSplititerator spliterator()

A Type Specific Type Splititerator to reduce boxing/unboxing

Returns:

type specific splititerator

Note:

characteristics are ordered, sized, subsized