[ library(m_map) | Reference Manual | Alphabetic Index ]
upper_bound_lookup(+Map, ++SearchKey, ?Key, ?Value)
Search a map for the largest key no larger than SearchKey.
- A map
- A key to search for
- The key found
- The value corresponding to Key
This predicate searches the map Map for the entry with the
largest key which is no larger than SearchKey. If such a key is
found, then it attempts to unify it with Key and the corresponding
value with Value. If such a key is not found, then it aborts with
a runtime error.
This predicate should only be called with maps created by other
predicates from the map module.
Fails if Key and Value do not unify with the key and value found.
lower_bound_search / 4, lower_bound_lookup / 4, upper_bound_search / 4