defineMap()

概要

新しい "マップ" を定義します。マップは、Intent セッションの間、維持されます。"マップ" のデータ構造は、"ハッシュ テーブル" や "ルックアップ テーブル" と呼ばれることがあります。同じ名前の別のマップを定義する場合は、reset? 引数は、既存のマップがオフになっているかどうかを指定します。 この関数は True を返します。

データを保存したりデータを取得しようとする前に、defineMap()を呼び出す必要があります。これは、onCreate rule を使用するには適しています。

構文

defineMap ( mapName As Name, _
            Optional reset? As Boolean = True ) As Boolean 

引数	[タイプ]	説明
mapName	Name	マップの名前です。
reset?	Boolean	True (既定値)、同じ名前のマップが存在する場合、マップ内のデータをその point オプションがオフになっています。 False の場合、何もマップ内の既存のデータに行われます。

例 1

初期定義

Intent >defineMap(:myMap) 
--> True 

' ' myMap という名前のマップを定義します。

例 2

再定義(reset? True 既定です)。

Intent >defineMap(:myMap) 
--> True 

この前に setMapValue ()を使用して設定されているすべての値をクリアする例 1 で定義されたマップを再定義します。

例 3

再定義(リセットしない場合)

この ' myMap という名前のマップ定義しようとします。 「Intent >defineMap(:myMap, reset? := False) 
--> True 

この名前は、reset? False を使用してマップのため、既存のマップはそのまま残ります。

例 4

この例では、マップを定義し、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