getMapValue()

概要

指定されたキーの下の、指定されたマップに保存された値を取得します。マップ名とキー名は、Name です。このようなマップがない場合、またはこのようなキーが定義されたマップにない場合は、NoValue を返します。

"マップ" データ構造は "ハッシュ テーブル" または "ルックアップ テーブル" とも呼ばれ、defineMap()を使用して作成されます。

構文

getMapValue ( map As Name, _
              key As Name ) As Any 

引数	[タイプ]	説明
map	[名前]	マップの名前です。defineMap() を使用して定義しておく必要があります。
key	[名前]	検索する値の名前です。SetMapValue()を使用して設定する必要があります。

例 1

この例では、マップを定義し、2 つの値を設定し、リセットせずにマップを再定義し、マップのキーと値を取得し、最後にマップ値を削除します。

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