Modern OrderedMap TryCeiling

Home › OrderedMap › OrderedMap and OrderedSet › OrderedMap.TryCeiling

OrderedMap.TryCeiling

Finds the smallest key at or above a given one; returns false if there is none.

Syntax

TryCeiling( k, byref outk ) as boolean

Examples

#import "std/containers"
using containers

dim m as OrderedMap( of integer, ustring )
m.Put( 10, "ten" ) : m.Put( 20, "twenty" ) : m.Put( 30, "thirty" )

dim as integer k

'' The smallest key that is NOT LESS than the argument
if m.TryCeiling( 25, k ) then print k  '' 30
if m.TryCeiling( 30, k ) then print k  '' 30 -- k itself when present
print m.TryCeiling( 99, k )            '' false -- every key is smaller

'' Floor and Ceiling together bracket a value that is not in the map

---

Library: OrderedMap and OrderedSet
Category: OrderedMap
Documented under: Members