speiger.src.collections.ints.maps.interfaces

Interface Int2ByteOrderedMap

All Superinterfaces:

Int2ByteFunction, Int2ByteMap, java.util.Map<java.lang.Integer,java.lang.Byte>

All Known Implementing Classes:

ImmutableInt2ByteOpenHashMap, Int2ByteArrayMap, Int2ByteLinkedOpenCustomHashMap, Int2ByteLinkedOpenHashMap, Int2ByteMaps.SynchronizedOrderedMap, Int2ByteMaps.UnmodifyableOrderedMap

public interface Int2ByteOrderedMap
extends Int2ByteMap

A Special Map 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/NaivgableMap implementations that still fit into here.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Int2ByteOrderedMap.FastOrderedSet Fast Ordered Entry Set that allows for a faster Entry Iterator by recycling the Entry Object and just exchanging 1 internal value

Nested classes/interfaces inherited from interface speiger.src.collections.ints.maps.interfaces.Int2ByteMap

Int2ByteMap.BuilderCache, Int2ByteMap.Entry, Int2ByteMap.FastEntrySet, Int2ByteMap.MapBuilder

Method Summary

Modifier and Type	Method and Description
Int2ByteOrderedMap	copy() A Function that does a shallow clone of the Map itself.
byte	firstByteValue() A method to get the first Value of a Map.
int	firstIntKey() A method to get the first Key of a Map.
byte	getAndMoveToFirst(int key) A Specific get method that allows to move teh given key/value int the first index.
byte	getAndMoveToLast(int key) A Specific get method that allows to move teh given key/value int the last index.
ObjectOrderedSet<Int2ByteMap.Entry>	int2ByteEntrySet() Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
IntOrderedSet	keySet()
byte	lastByteValue() A method to get the last Value of a Map.
int	lastIntKey() A method to get the last Key of a Map.
boolean	moveToFirst(int key) A specific move method to move a given key/value to the first index.
boolean	moveToLast(int key) A specific move method to move a given key/value to the last index.
int	pollFirstIntKey() A method to get and remove the first Key of a Map.
int	pollLastIntKey() A method to get and remove the last Key of a Map.
byte	putAndMoveToFirst(int key, byte value) A customized put method that allows you to insert into the first index.
byte	putAndMoveToLast(int key, byte value) A customized put method that allows you to insert into the last index.
default Int2ByteOrderedMap	synchronize() Creates a Wrapped SortedMap that is Synchronized
default Int2ByteOrderedMap	synchronize(java.lang.Object mutex) Creates a Wrapped SortedMap that is Synchronized
default Int2ByteOrderedMap	unmodifiable() Creates a Wrapped SortedMap that is unmodifiable

Methods inherited from interface speiger.src.collections.ints.maps.interfaces.Int2ByteMap

addTo, addToAll, builder, compute, computeByte, computeByteIfAbsent, computeByteIfPresent, computeIfAbsent, computeIfPresent, containsKey, containsKey, containsValue, containsValue, entrySet, forEach, forEach, get, get, getDefaultReturnValue, getOrDefault, getOrDefault, merge, mergeAllByte, mergeByte, put, put, putAll, putAll, putAll, putAll, putAll, putAllIfAbsent, putIfAbsent, putIfAbsent, remove, remove, remove, remove, removeOrDefault, replace, replace, replace, replace, replaceAll, replaceBytes, replaceBytes, setDefaultReturnValue, subFrom, supplyByteIfAbsent, values

Methods inherited from interface java.util.Map

clear, equals, hashCode, isEmpty, putAll, size

Method Detail

putAndMoveToFirst

byte putAndMoveToFirst(int key,
                       byte value)

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

Parameters:

key - the key that should be inserted

value - the value that should be inserted

Returns:

the previous present or default return value

See Also:

Map.put(Object, Object)

putAndMoveToLast

byte putAndMoveToLast(int key,
                      byte value)

A customized put method that allows you to insert into the last index. (This may be nessesary depending on the implementation)

Parameters:

key - the key that should be inserted

value - the value that should be inserted

Returns:

the previous present or default return value

See Also:

Map.put(Object, Object)

moveToFirst

boolean moveToFirst(int key)

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

Parameters:

key - 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(int key)

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

Parameters:

key - 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

getAndMoveToFirst

byte getAndMoveToFirst(int key)

A Specific get method that allows to move teh given key/value int the first index.

Parameters:

key - that is searched for

Returns:

the given value for the requested key or default return value

getAndMoveToLast

byte getAndMoveToLast(int key)

A Specific get method that allows to move teh given key/value int the last index.

Parameters:

key - that is searched for

Returns:

the given value for the requested key or default return value

firstIntKey

int firstIntKey()

A method to get the first Key of a Map.

Returns:

the first key in the map

pollFirstIntKey

int pollFirstIntKey()

A method to get and remove the first Key of a Map.

Returns:

the first key in the map

lastIntKey

int lastIntKey()

A method to get the last Key of a Map.

Returns:

the last key in the map

pollLastIntKey

int pollLastIntKey()

A method to get and remove the last Key of a Map.

Returns:

the last key in the map

firstByteValue

byte firstByteValue()

A method to get the first Value of a Map.

Returns:

the first key in the map

lastByteValue

byte lastByteValue()

A method to get the last Value of a Map.

Returns:

the last key in the map

copy

Int2ByteOrderedMap copy()

Description copied from interface: Int2ByteMap

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

Specified by:

copy in interface Int2ByteMap

Returns:

a Shallow Copy of the Map

keySet

IntOrderedSet keySet()

Specified by:

keySet in interface Int2ByteMap

Specified by:

keySet in interface java.util.Map<java.lang.Integer,java.lang.Byte>

int2ByteEntrySet

ObjectOrderedSet<Int2ByteMap.Entry> int2ByteEntrySet()

Description copied from interface: Int2ByteMap

Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.

Specified by:

int2ByteEntrySet in interface Int2ByteMap

Returns:

a EntrySet of the collection

synchronize

default Int2ByteOrderedMap synchronize()

Creates a Wrapped SortedMap that is Synchronized

Specified by:

synchronize in interface Int2ByteMap

Returns:

a new SortedMap that is synchronized

See Also:

Int2ByteMaps.synchronize(speiger.src.collections.ints.maps.interfaces.Int2ByteMap)

synchronize

default Int2ByteOrderedMap synchronize(java.lang.Object mutex)

Creates a Wrapped SortedMap that is Synchronized

Specified by:

synchronize in interface Int2ByteMap

Parameters:

mutex - is the controller of the synchronization block

Returns:

a new SortedMap Wrapper that is synchronized

See Also:

Int2ByteMaps.synchronize(speiger.src.collections.ints.maps.interfaces.Int2ByteMap)

unmodifiable

default Int2ByteOrderedMap unmodifiable()

Creates a Wrapped SortedMap that is unmodifiable

Specified by:

unmodifiable in interface Int2ByteMap

Returns:

a new SortedMap Wrapper that is unmodifiable

See Also:

Int2ByteMaps.unmodifiable(speiger.src.collections.ints.maps.interfaces.Int2ByteMap)