net.sf.saxon.ma.trie

Interface ImmutableMap<K,V>

All Known Implementing Classes:

ImmutableHashTrieMap

public interface ImmutableMap<K,V>

Method Summary

Modifier and Type	Method and Description
V	get(K key) Retrieve a stored value from the map based on the key for the associated entry.
java.util.Iterator<Tuple2<K,V>>	iterator() Iterate over the entries in the map
ImmutableMap<K,V>	put(K key, V value) Add a new entry to the map.
ImmutableMap<K,V>	remove(K key) Remove an entry from the map.

Method Detail

put

ImmutableMap<K,V> put(K key,
                      V value)

Add a new entry to the map. If an entry already exists with the given key, the returned map will contain this entry, but not the existing entry.

Parameters:

key - the key to use to retrieve this item

value - the value stored for this item

Returns:

a new map with this item added

remove

ImmutableMap<K,V> remove(K key)

Remove an entry from the map. If no entry exists with the given key, the returned map will have identical contents to the original map (and may, in fact, be the original map itself).

Parameters:

key - the key for the entry to remove

Returns:

a new map with the entry with the given key removed (or a map with the original contents if no entry was found for the given key).

get

V get(K key)

Retrieve a stored value from the map based on the key for the associated entry. If no entry exists with the given key, we return None.

Parameters:

key - the key for the entry to retrieve

Returns:

Some(value) if an entry exists with the given key, or None if no entry with the given key was found.

iterator

java.util.Iterator<Tuple2<K,V>> iterator()

Iterate over the entries in the map

Returns:

an iterator over the key-value pairs held in the map