speiger.src.collections.bytes.sets

Interface ByteOrderedSet

All Superinterfaces:

ByteCollection, ByteIterable, ByteSet, java.util.Collection<java.lang.Byte>, java.lang.Iterable<java.lang.Byte>, java.util.Set<java.lang.Byte>

All Known Implementing Classes:

ByteArraySet, ByteLinkedOpenCustomHashSet, ByteLinkedOpenHashSet, ImmutableByteOpenHashSet

public interface ByteOrderedSet
extends ByteSet

A Special Set Interface giving Access to some really usefull functions The Idea behind this interface is to allow access to functions that give control to the Order of elements. Since Linked implementations as examples can be reordered outside of the Insertion Order. This interface provides basic access to such functions while also providing some Sorted/NaivgableSet implementations that still fit into here.

Method Summary

Modifier and Type	Method and Description
boolean	addAndMoveToFirst(byte o) A customized add method that allows you to insert into the first index.
boolean	addAndMoveToLast(byte o) A customized add method that allows you to insert into the last index.
ByteOrderedSet	copy() A Function that does a shallow clone of the Collection itself.
byte	firstByte() A method to get the first element in the set
ByteBidirectionalIterator	iterator() Returns a Type-Specific Iterator to reduce (un)boxing
ByteBidirectionalIterator	iterator(byte fromElement) A type Specific Iterator starting from a given key
byte	lastByte() A method to get the last element in the set
boolean	moveToFirst(byte o) A specific move method to move a given key to the first index.
boolean	moveToLast(byte o) A specific move method to move a given key to the last index.
byte	pollFirstByte() A method to get and remove the first element in the set
byte	pollLastByte() A method to get and remove the last element in the set
default ByteSplititerator	spliterator() A Type Specific Type Splititerator to reduce boxing/unboxing
default ByteOrderedSet	synchronize() Creates a Wrapped OrderedSet that is Synchronized
default ByteOrderedSet	synchronize(java.lang.Object mutex) Creates a Wrapped OrderedSet that is Synchronized
default ByteOrderedSet	unmodifiable() Creates a Wrapped OrderedSet that is unmodifiable

Methods inherited from interface speiger.src.collections.bytes.sets.ByteSet

add, contains, remByte, remove, remove

Methods inherited from interface java.util.Set

addAll, clear, containsAll, equals, hashCode, isEmpty, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface speiger.src.collections.bytes.collections.ByteCollection

add, addAll, addAll, addAll, addAll, contains, containsAll, containsAny, containsAny, parallelPrimitiveStream, pour, primitiveStream, remIf, removeAll, removeAll, removeIf, retainAll, retainAll, toByteArray, toByteArray

Methods inherited from interface java.util.Collection

parallelStream, stream

Methods inherited from interface speiger.src.collections.bytes.collections.ByteIterable

arrayflatMap, asAsync, count, distinct, filter, findFirst, flatMap, forEach, forEach, forEach, limit, map, matchesAll, matchesAny, matchesNone, peek, pourAsList, pourAsSet, reduce, reduce, sorted

Method Detail

addAndMoveToFirst

boolean addAndMoveToFirst(byte o)

A customized add method that allows you to insert into the first index.

Parameters:

o - the element that should be inserted

Returns:

true if it was added

See Also:

Set.add(Object)

addAndMoveToLast

boolean addAndMoveToLast(byte o)

A customized add method that allows you to insert into the last index.

Parameters:

o - the element that should be inserted

Returns:

true if it was added

See Also:

Set.add(Object)

moveToFirst

boolean moveToFirst(byte o)

A specific move method to move a given key to the first index.

Parameters:

o - that should be moved to the first index

Returns:

true if the value was moved.

Note:

returns false if the value was not present in the first place

moveToLast

boolean moveToLast(byte o)

A specific move method to move a given key to the last index.

Parameters:

o - that should be moved to the first last

Returns:

true if the value was moved.

Note:

returns false if the value was not present in the first place

copy

ByteOrderedSet copy()

Description copied from interface: ByteCollection

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 ByteCollection

Specified by:

copy in interface ByteSet

Returns:

a Shallow Copy of the collection

iterator

ByteBidirectionalIterator iterator()

Description copied from interface: ByteCollection

Returns a Type-Specific Iterator to reduce (un)boxing

Specified by:

iterator in interface ByteCollection

Specified by:

iterator in interface ByteIterable

Specified by:

iterator in interface ByteSet

Specified by:

iterator in interface java.util.Collection<java.lang.Byte>

Specified by:

iterator in interface java.lang.Iterable<java.lang.Byte>

Specified by:

iterator in interface java.util.Set<java.lang.Byte>

Returns:

a iterator of the collection

See Also:

Collection.iterator()

iterator

ByteBidirectionalIterator iterator(byte fromElement)

A type Specific Iterator starting from a given key

Parameters:

fromElement - the element the iterator should start from

Returns:

a iterator starting from the given element

Throws:

java.util.NoSuchElementException - if fromElement isn't found

spliterator

default ByteSplititerator spliterator()

A Type Specific Type Splititerator to reduce boxing/unboxing

Specified by:

spliterator in interface ByteCollection

Specified by:

spliterator in interface ByteIterable

Specified by:

spliterator in interface ByteSet

Specified by:

spliterator in interface java.util.Collection<java.lang.Byte>

Specified by:

spliterator in interface java.lang.Iterable<java.lang.Byte>

Specified by:

spliterator in interface java.util.Set<java.lang.Byte>

Returns:

type specific splititerator

firstByte

byte firstByte()

A method to get the first element in the set

Returns:

first element in the set

pollFirstByte

byte pollFirstByte()

A method to get and remove the first element in the set

Returns:

first element in the set

lastByte

byte lastByte()

A method to get the last element in the set

Returns:

last element in the set

pollLastByte

byte pollLastByte()

A method to get and remove the last element in the set

Returns:

last element in the set

synchronize

default ByteOrderedSet synchronize()

Creates a Wrapped OrderedSet that is Synchronized

Specified by:

synchronize in interface ByteCollection

Specified by:

synchronize in interface ByteSet

Returns:

a new OrderedSet that is synchronized

See Also:

ByteSets.synchronize(speiger.src.collections.bytes.sets.ByteSet)

synchronize

default ByteOrderedSet synchronize(java.lang.Object mutex)

Creates a Wrapped OrderedSet that is Synchronized

Specified by:

synchronize in interface ByteCollection

Specified by:

synchronize in interface ByteSet

Parameters:

mutex - is the controller of the synchronization block

Returns:

a new OrderedSet Wrapper that is synchronized

See Also:

ByteSets.synchronize(speiger.src.collections.bytes.sets.ByteSet)

unmodifiable

default ByteOrderedSet unmodifiable()

Creates a Wrapped OrderedSet that is unmodifiable

Specified by:

unmodifiable in interface ByteCollection

Specified by:

unmodifiable in interface ByteSet

Returns:

a new OrderedSet Wrapper that is unmodifiable

See Also:

ByteSets.unmodifiable(speiger.src.collections.bytes.sets.ByteSet)