Long2ObjectMaps (Primitive-Collections 0.8.0 API)

java.lang.Object
- speiger.src.collections.longs.utils.maps.Long2ObjectMaps

```
public class Long2ObjectMaps
extends java.lang.Object
```
A Helper class that provides you with Singleton/Empty/Synchronized/Unmodifyable Maps

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Long2ObjectMaps.EmptyMap<V>` Empty Map impementation that is used for the emptyMap() function
`static class`	`Long2ObjectMaps.SingletonMap<V>` Singleton Map instance that is used in the helper method
`static class`	`Long2ObjectMaps.SynchronizedMap<V>` The Synchronized Map implementation used by the synchronizedMap helper function
`static class`	`Long2ObjectMaps.SynchronizedNavigableMap<V>` The Synchronized Navigable Map implementation used by the synchronizedMap helper function
`static class`	`Long2ObjectMaps.SynchronizedOrderedMap<V>` The Synchronized Ordered Map implementation used by the synchronizedMap helper function
`static class`	`Long2ObjectMaps.SynchronizedSortedMap<V>` The Synchronized Sorted Map implementation used by the synchronizedMap helper function
`static class`	`Long2ObjectMaps.UnmodifyableEntry<V>` The Unmodifyable Entry implementation for the helper function unmodifiableEntry()
`static class`	`Long2ObjectMaps.UnmodifyableEntrySet<V>` The Unmodifyable Set implementation for the Unmodifyable Map implementation
`static class`	`Long2ObjectMaps.UnmodifyableMap<V>` The Unmodifyable Map implementation that is sued for the unmodifyableMap function
`static class`	`Long2ObjectMaps.UnmodifyableNavigableMap<V>` The Unmodifyable Navigable Map implementation that is sued for the unmodifyableMap function
`static class`	`Long2ObjectMaps.UnmodifyableOrderedEntrySet<V>` The Unmodifyable Ordered Set implementation for the Unmodifyable Ordered Map implementation
`static class`	`Long2ObjectMaps.UnmodifyableOrderedMap<V>` The Unmodifyable Ordered Map implementation that is sued for the unmodifyableMap function
`static class`	`Long2ObjectMaps.UnmodifyableSortedMap<V>` The Unmodifyable Sorted Map implementation that is sued for the unmodifyableMap function

Constructor Summary

Constructors
Constructor and Description

Long2ObjectMaps()

Constructors
Constructor and Description
`Long2ObjectMaps()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <V> Long2ObjectMap<V>`	`empty()` Empty Map getter function that autocasts to the desired Key and Value
`static <V> void`	`fastForEach(Long2ObjectMap<V> map, java.util.function.Consumer<Long2ObjectMap.Entry<V>> action)` A Helper function that provides a faster forEach iterator implementation that recycles the entry to increase throughput
`static <V> ObjectIterable<Long2ObjectMap.Entry<V>>`	`fastIterable(Long2ObjectMap<V> map)` Helper method that provides the fastIterable that recycles a single Entry to increase throughput.
`static <V> ObjectIterator<Long2ObjectMap.Entry<V>>`	`fastIterator(Long2ObjectMap<V> map)` Helper method that provides the fastIterator that recycles a single Entry to increase throughput.
`static <V> Long2ObjectMap<V>`	`singleton(long key, V value)` Creates a Singleton map from the provided values.
`static <V> Long2ObjectMap<V>`	`synchronize(Long2ObjectMap<V> map)` Helper function that creates a Helper wrapper to synchronize access into the map.
`static <V> Long2ObjectMap<V>`	`synchronize(Long2ObjectMap<V> map, java.lang.Object mutex)` Helper function that creates a Helper wrapper to synchronize access with custom access control into the map.
`static <V> Long2ObjectNavigableMap<V>`	`synchronize(Long2ObjectNavigableMap<V> map)` Helper function that creates a Helper wrapper to synchronize access into the NavigableMap.
`static <V> Long2ObjectNavigableMap<V>`	`synchronize(Long2ObjectNavigableMap<V> map, java.lang.Object mutex)` Helper function that creates a Helper wrapper to synchronize access with custom access control into the NavigableMap.
`static <V> Long2ObjectOrderedMap<V>`	`synchronize(Long2ObjectOrderedMap<V> map)` Helper function that creates a Helper wrapper to synchronize access into the OrderedMap.
`static <V> Long2ObjectOrderedMap<V>`	`synchronize(Long2ObjectOrderedMap<V> map, java.lang.Object mutex)` Helper function that creates a Helper wrapper to synchronize access with custom access control into the OrderedMap.
`static <V> Long2ObjectSortedMap<V>`	`synchronize(Long2ObjectSortedMap<V> map)` Helper function that creates a Helper wrapper to synchronize access into the SortedMap.
`static <V> Long2ObjectSortedMap<V>`	`synchronize(Long2ObjectSortedMap<V> map, java.lang.Object mutex)` Helper function that creates a Helper wrapper to synchronize access with custom access control into the SortedMap.
`static <V> Long2ObjectMap.Entry<V>`	`unmodifiable(Long2ObjectMap.Entry<V> entry)` A Helper function that creates a Unmodifyable Entry
`static <V> Long2ObjectMap<V>`	`unmodifiable(Long2ObjectMap<V> map)` A Helper function that creates a Helper wrapper to only allow Read Access into the Map
`static <V> Long2ObjectNavigableMap<V>`	`unmodifiable(Long2ObjectNavigableMap<V> map)` A Helper function that creates a Helper wrapper to only allow Read Access into NavigableMap Map
`static <V> Long2ObjectOrderedMap<V>`	`unmodifiable(Long2ObjectOrderedMap<V> map)` A Helper function that creates a Helper wrapper to only allow Read Access into the OrderedMap
`static <V> Long2ObjectSortedMap<V>`	`unmodifiable(Long2ObjectSortedMap<V> map)` A Helper function that creates a Helper wrapper to only allow Read Access into the SortedMap
`static <V> Long2ObjectMap.Entry<V>`	`unmodifiable(java.util.Map.Entry<java.lang.Long,V> entry)` A Helper function that creates a Unmodifyable Entry

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Long2ObjectMaps
```
public Long2ObjectMaps()
```
- Method Detail
  - empty
```
public static <V> Long2ObjectMap<V> empty()
```
    Empty Map getter function that autocasts to the desired Key and Value
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Returns:
    
    empty map of desired type
  - fastIterator
```
public static <V> ObjectIterator<Long2ObjectMap.Entry<V>> fastIterator(Long2ObjectMap<V> map)
```
    Helper method that provides the fastIterator that recycles a single Entry to increase throughput.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the map the fastIterator should be accessed from
    
    Returns:
    
    either a normal iterator if it does not support this feature to a fastIterator
  - fastIterable
```
public static <V> ObjectIterable<Long2ObjectMap.Entry<V>> fastIterable(Long2ObjectMap<V> map)
```
    Helper method that provides the fastIterable that recycles a single Entry to increase throughput.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the map the fastIterable should be accessed from
    
    Returns:
    
    either a normal iterable if it does not support this feature to a fastIterable
  - fastForEach
```
public static <V> void fastForEach(Long2ObjectMap<V> map,
                                   java.util.function.Consumer<Long2ObjectMap.Entry<V>> action)
```
    A Helper function that provides a faster forEach iterator implementation that recycles the entry to increase throughput
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the map the fast forEach should be accessed from
    
    action - the action that should be performed on each entry
    
    Note:
    
    if the fast forEach is not supported will default to a normal forEach
  - synchronize
```
public static <V> Long2ObjectMap<V> synchronize(Long2ObjectMap<V> map)
```
    Helper function that creates a Helper wrapper to synchronize access into the map.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the map that should be synchronized
    
    Returns:
    
    a synchronized Map
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectMap<V> synchronize(Long2ObjectMap<V> map,
                                                java.lang.Object mutex)
```
    Helper function that creates a Helper wrapper to synchronize access with custom access control into the map.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the map that should be synchronized
    
    mutex - the object that controls access
    
    Returns:
    
    a synchronized Map
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectSortedMap<V> synchronize(Long2ObjectSortedMap<V> map)
```
    Helper function that creates a Helper wrapper to synchronize access into the SortedMap.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the SortedMap that should be synchronized
    
    Returns:
    
    a synchronized SortedMap
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectSortedMap<V> synchronize(Long2ObjectSortedMap<V> map,
                                                      java.lang.Object mutex)
```
    Helper function that creates a Helper wrapper to synchronize access with custom access control into the SortedMap.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the SortedMap that should be synchronized
    
    mutex - the object that controls access
    
    Returns:
    
    a synchronized SortedMap
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectOrderedMap<V> synchronize(Long2ObjectOrderedMap<V> map)
```
    Helper function that creates a Helper wrapper to synchronize access into the OrderedMap.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the OrderedMap that should be synchronized
    
    Returns:
    
    a synchronized OrderedMap
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectOrderedMap<V> synchronize(Long2ObjectOrderedMap<V> map,
                                                       java.lang.Object mutex)
```
    Helper function that creates a Helper wrapper to synchronize access with custom access control into the OrderedMap.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the OrderedMap that should be synchronized
    
    mutex - the object that controls access
    
    Returns:
    
    a synchronized OrderedMap
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectNavigableMap<V> synchronize(Long2ObjectNavigableMap<V> map)
```
    Helper function that creates a Helper wrapper to synchronize access into the NavigableMap.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the NavigableMap that should be synchronized
    
    Returns:
    
    a synchronized NavigableMap
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - synchronize
```
public static <V> Long2ObjectNavigableMap<V> synchronize(Long2ObjectNavigableMap<V> map,
                                                         java.lang.Object mutex)
```
    Helper function that creates a Helper wrapper to synchronize access with custom access control into the NavigableMap.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the NavigableMap that should be synchronized
    
    mutex - the object that controls access
    
    Returns:
    
    a synchronized NavigableMap
    
    Note:
    
    if the inputted map is already synchronized then it will just return it instead, iterators do not support synchronization
  - unmodifiable
```
public static <V> Long2ObjectMap<V> unmodifiable(Long2ObjectMap<V> map)
```
    A Helper function that creates a Helper wrapper to only allow Read Access into the Map
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the map that should be made Unmodifiable
    
    Returns:
    
    a unmodifiable Map
    
    Note:
    
    if the inputted map is already unmodifiable then it will just return it instead
  - unmodifiable
```
public static <V> Long2ObjectOrderedMap<V> unmodifiable(Long2ObjectOrderedMap<V> map)
```
    A Helper function that creates a Helper wrapper to only allow Read Access into the OrderedMap
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the OrderedMap that should be made Unmodifiable
    
    Returns:
    
    a unmodifiable OrderedMap
    
    Note:
    
    if the inputted OrderedMap is already unmodifiable then it will just return it instead
  - unmodifiable
```
public static <V> Long2ObjectSortedMap<V> unmodifiable(Long2ObjectSortedMap<V> map)
```
    A Helper function that creates a Helper wrapper to only allow Read Access into the SortedMap
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the SortedMap that should be made Unmodifiable
    
    Returns:
    
    a unmodifiable SortedMap
    
    Note:
    
    if the inputted SortedMap is already unmodifiable then it will just return it instead
  - unmodifiable
```
public static <V> Long2ObjectNavigableMap<V> unmodifiable(Long2ObjectNavigableMap<V> map)
```
    A Helper function that creates a Helper wrapper to only allow Read Access into NavigableMap Map
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    map - the NavigableMap that should be made Unmodifiable
    
    Returns:
    
    a unmodifiable NavigableMap
    
    Note:
    
    if the inputted NavigableMap is already unmodifiable then it will just return it instead
  - unmodifiable
```
public static <V> Long2ObjectMap.Entry<V> unmodifiable(Long2ObjectMap.Entry<V> entry)
```
    A Helper function that creates a Unmodifyable Entry
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    entry - the Entry that should be made unmodifiable
    
    Returns:
    
    a Unmodifyable Entry
  - unmodifiable
```
public static <V> Long2ObjectMap.Entry<V> unmodifiable(java.util.Map.Entry<java.lang.Long,V> entry)
```
    A Helper function that creates a Unmodifyable Entry
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    entry - the Entry that should be made unmodifiable
    
    Returns:
    
    a Unmodifyable Entry
  - singleton
```
public static <V> Long2ObjectMap<V> singleton(long key,
                                              V value)
```
    Creates a Singleton map from the provided values. This reduces overhead that normal Map implementations have.
    
    Type Parameters:
    
    V - the keyType of elements maintained by this Collection
    
    Parameters:
    
    key - the key that should be turned into a singleton
    
    value - the value that should be turned into a singleton
    
    Returns:
    
    a unmodifiable Singleton map.

Class Long2ObjectMaps

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Long2ObjectMaps

Method Detail

empty

fastIterator

fastIterable

fastForEach

synchronize

synchronize

synchronize

synchronize

synchronize

synchronize

synchronize

synchronize

unmodifiable

unmodifiable

unmodifiable

unmodifiable

unmodifiable

unmodifiable

singleton