XAddGetMap (MicroStream API)

All Superinterfaces:

CapacityCarrying, CapacityExtendable, Copyable, ExtendedCollection<KeyValue<K,V>>, ExtendedMap<K,V>, Iterable<KeyValue<K,V>>, Sized, XAddingMap<K,V>, XGettingCollection<KeyValue<K,V>>, XGettingMap<K,V>, XGettingSet<KeyValue<K,V>>, XIterable<KeyValue<K,V>>, XJoinable<KeyValue<K,V>>

All Known Subinterfaces:

XBasicTable<K,V>, XChart<K,V>, XMap<K,V>, XPutGetMap<K,V>, XTable<K,V>

All Known Implementing Classes:

EqHashTable, HashTable, LockedMap
```
public interface XAddGetMap<K,V>
extends XAddingMap<K,V>, XGettingMap<K,V>
```

Nested Class Summary

Nested Classes
Modifier and Type Interface Description

static interface XAddGetMap.Creator<K,V>
- Nested classes/interfaces inherited from interface one.microstream.typing.Copyable
  Copyable.Static
- Nested classes/interfaces inherited from interface one.microstream.collections.types.XGettingMap
  XGettingMap.Bridge<K,V>, XGettingMap.EntriesBridge<K,V>, XGettingMap.Keys<K,V>, XGettingMap.Satellite<K,V>, XGettingMap.Values<K,V>
- Nested classes/interfaces inherited from interface one.microstream.collections.types.XIterable
  XIterable.Executor<E>

Method Summary

Modifier and Type	Method	Description
`KeyValue<K,V>`	`addGet(K key, V value)`
`V`	`ensure(K key, Function<? super K,V> valueProvider)`	Ensures that this map instance contains a non-null value for the passed key and returns that value.
`KeyValue<K,V>`	`substitute(K key, V value)`

Methods inherited from interface one.microstream.collections.interfaces.CapacityCarrying
isFull, maximumCapacity, remainingCapacity

Methods inherited from interface one.microstream.collections.interfaces.CapacityExtendable
currentCapacity, currentFreeCapacity, ensureCapacity, ensureFreeCapacity

Methods inherited from interface one.microstream.collections.interfaces.ExtendedCollection
nullAllowed

Methods inherited from interface java.lang.Iterable
forEach, spliterator

Methods inherited from interface one.microstream.collections.interfaces.Sized
isEmpty

Methods inherited from interface one.microstream.collections.types.XAddingMap
add, nullKeyAllowed, nullValuesAllowed, set, valueSet

Methods inherited from interface one.microstream.collections.types.XGettingCollection
applies, contains, containsAll, containsId, containsSearched, copyTo, count, countBy, distinct, distinct, equality, equals, equals, equalsContent, except, filterTo, get, hashCode, hasVolatileElements, intersect, intSize, iterator, join, max, min, nullContained, search, seek, size, toArray, toArray, union

Methods inherited from interface one.microstream.collections.types.XGettingMap
copy, get, immure, keys, lookup, nullKeyAllowed, nullValuesAllowed, old, oldMap, query, searchValue, values, view

Methods inherited from interface one.microstream.collections.types.XGettingSet
iterate

- Method Detail
  - addGet
```
KeyValue<K,V> addGet(K key,
                           V value)
```
  - substitute
```
KeyValue<K,V> substitute(K key,
                               V value)
```
  - ensure
```
V ensure(K key,
         Function<? super K,V> valueProvider)
```
    Ensures that this map instance contains a non-null value for the passed key and returns that value.
    If a non-null value can be found for the passed key, it is returned. Otherwise, the value provided by the passed supplier will be associated with the passed key and is returned.
    
    Parameters:
    
    key - the search key.
    
    valueProvider - the value supplier used to provide a value for the passed key in case non could be found.
    
    Returns:
    
    the value associated with the passed key, either already existing or newly assiciated by the call of this method.