Map
A map container backed by either a hash map or a linked hash map.
Map type
map<KeyType, ValueType>
| Subtypes | Supertypes | Comparable types |
|---|---|---|
| sorted_map<KeyType, ValueType> | sequence< mapping<KeyType, ValueType> > | java.util.Map<KeyType, ValueType> |
The map type is retrofitted to be a subtype of sequence.
Map creation
new hashmap
new linked_hashmap
| Parameter type | Result type |
|---|---|
| (KeyType => ValueType)... | map<KeyType, ValueType> |
Creates an empty map. Optionally, initial values may be specified right in the new map creation expression.
map<string, int> map = new hashmap<string, int> {"A" = 1, "B" = 2, "C" = 3}; Operations on map
get value by key
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | KeyType | ValueType |
int value = map["key"]; keys
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | none | sequence<KeyType> |
Results in a sequence containing all the keys in the map.
sequence<string> keys = map.keys; containsKey
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | KeyType | boolean |
Returns true if the map contains a mapping for the specified key, false otherwise.
map.containsKey ("key"); values
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | none | sequence<ValueType> |
Results in a sequence containing all the values in the map.
sequence<string> values = map.values; containsValue
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | ValueType | boolean |
Returns true if the map contains a mapping with the specified value, false otherwise.
map.containsValue ("value");
mappings
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | none | set< mapping<KeyType, ValueType> > |
Results in a set of mappings contained by this map. The mappings can be removed from the set, but not added.
set<mappings<K,V>> = map.mappings; assign value to a key
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | KeyType | ValueType |
map["key"] = value; remove
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | KeyType | void |
Removes the specified key and the associated value from the map.
map.remove ("key"); clear
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | none | void |
Clears all key-value pairs from the map.
map.clear; putAll
| Operand type | Parameter type | Result type |
|---|---|---|
| map<KeyType, ValueType> | map<KeyType, ValueType> | void |
Puts all mappings from the map specified as a parameter into this map, replacing existing mappings.
map.putAll (anotherMap);