getMapKeys()

Synopsis

Returns a list of names , which are the keys of tableID. Returns NoValue if there is no map for the given tableID.

A "map" data structure is sometimes referred to as a "hash table" or "lookup table" and is created with defineMap().

Syntax

getMapKeys ( tableID As Name ) As Boolean 

Argument	Type	Description
tableID	Name	The name of the Map. Must have been previously created with defineMap().

Example 1

This example defines a map, sets a couple values, defines the map again without resetting it, gets map keys and some values, and finally deletes a map value.

Intent >defineMap(:myMap)
--> True
Intent >setMapValue(:myMap, :myStringValue, "A String")
--> True
Intent >setMapValue(:myMap, :myIntegerValue, 123)
--> True
Intent >defineMap(:myMap, reset? := False)
--> True
Intent >getMapKeys(:myMap)
--> {:myStringValue, :myIntegerValue}
Intent >getMapValue(:myMap, :myStringValue)
--> "A String"
Intent >getMapValue(:noMap, :noValue)
--> NoValue
Intent >deleteMapValue(:myMap, :myIntegerValue)
--> True
Intent >getMapValue(:myMap, :myIntegerValue)
--> NoValue