How to add your knowledge

getMapKeys()

    Table of contents
    1. 1. Synopsis
    2. 2. Syntax
    3. 3. Example 1

    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