public interface BinaryLongMap
Modifier and Type | Interface and Description |
---|---|
static interface |
BinaryLongMap.Entry
Represents an Entry stored in a BinaryLongMap.
|
static interface |
BinaryLongMap.EntryVisitor
Represent a visitor to be applied to one or more entries in the BinaryLongMap.
|
static class |
BinaryLongMap.SimpleMapImpl
A java.util.Map<Binary, Long> implementation.
|
Modifier and Type | Method and Description |
---|---|
void |
clear()
Initialize the map to an empty state.
|
long |
get(Binary binKey)
Find the specified key in the map and return the value associated with it.
|
void |
internKeys(Object o)
Internal opaque method: De-duplicate keys.
|
Iterator<Binary> |
keys()
Obtain an iterator of the keys stored in the map.
|
Iterator<Binary> |
keys(Predicate<BinaryLongMap.Entry> predicate)
Obtain an iterator of the keys stored in the map whose corresponding
Entry matches the passed Predicate<Entry> . |
void |
put(Binary binKey, long lValue)
Blindly store the passed value for the specified key, adding the key if it is not already in the map, or replacing the current value if the key is in the map.
|
boolean |
putIfAbsent(Binary binKey, long lValue)
Store the passed value for the specified key, only if the key does not currently exist in the map.
|
void |
remove(Binary binKey)
Blindly remove the specified Binary key from the map.
|
boolean |
remove(Binary binKey, long lValue)
Remove the specified Binary key from the map iff it exists in the map and is associated with the specified value.
|
boolean |
replace(Binary binKey, long lValueOld, long lValueNew)
Store the passed "new" value for the specified key, only if the current value associated with the specified key is the same as the specified "old" value.
|
int |
size()
Determine the size of the map.
|
void |
visit(Binary binKey, BinaryLongMap.EntryVisitor visitor)
Apply the specified visitor to the entry associated with the specified key, if the entry exists or may be added.
|
void |
visitAll(BinaryLongMap.EntryVisitor visitor)
Apply the specified visitor to all entries in the BinaryLongMap.
|
long get(Binary binKey)
binKey
- a Binary keyvoid put(Binary binKey, long lValue)
Note that associating the value zero with a key is analogous to removing the key.
binKey
- the Binary key to add or updatelValue
- the value to associate with the keyboolean putIfAbsent(Binary binKey, long lValue)
Note that associating the value zero with a key using this method will have no effect, since were that key already present, there would be no change, and were it not present, the value zero is analogous to removing the key, which again is no change (since it is not present).
binKey
- a Binary keylValue
- the new value to associate with the passed keyboolean replace(Binary binKey, long lValueOld, long lValueNew)
Note that replacing the value of zero is analogous to putIfAbsent
, and associating the value zero with a key using this method is the same as remove
passing the old value to match.
binKey
- a Binary keylValueOld
- the assumed old value to replacelValueNew
- the new value to associate with the passed keyvoid remove(Binary binKey)
binKey
- a Binary keyboolean remove(Binary binKey, long lValue)
Note that removing an association whose value is zero has no effect.
binKey
- a Binary keylValue
- the value that the key must have in order to be removedvoid clear()
int size()
Iterator<Binary> keys()
Iterator<Binary> keys(Predicate<BinaryLongMap.Entry> predicate)
Entry
matches the passed Predicate<Entry>
.
The entry passed to the predicate should be treated as read-only, and any attempt to modify the entry may have undefined behavior and/or throw an Exception. Modifications to entries should instead be performed using an BinaryLongMap.EntryVisitor
via the visit(com.tangosol.util.Binary, com.tangosol.util.BinaryLongMap.EntryVisitor)
or visitAll(com.tangosol.util.BinaryLongMap.EntryVisitor)
methods.
predicate
- a Predicate<Entry> to apply to each Entryvoid visit(Binary binKey, BinaryLongMap.EntryVisitor visitor)
BinaryLongMap.Entry.setValue(long)
).binKey
- the key to visitvisitor
- the visitor to applyvoid visitAll(BinaryLongMap.EntryVisitor visitor)
visitor
- the visitor to applyvoid internKeys(Object o)
o
- some implementation-specific object