[ library(m_map) | Reference Manual | Alphabetic Index ]
insert(+Map0, ++Key, ?Value, -Map)
Insert a key/value pair into a map, failing if the key already exists.
- Map0
- A map
- Key
- A key to insert
- Value
- The value corresponding to Key
- Map
- The map after insertion
Description
This predicate inserts the key Key with corresponding value Value
into the map Map0, resulting in the map Map. If the key Key is
already in the map, then the predicate fails.
This predicate should only be called with maps created by other
predicates from the map module.
Fail Conditions
Fails if Key already appears in Map0.
Resatisfiable
no
See Also
det_insert / 4, update / 4, det_update / 4, set / 4