deleteMapValue()

概要

tableID のキーによって特定されたエントリを削除します。指定された tableID のマップがない場合、またはキーが見つからない場合には False を返します。エントリが見つかり削除された場合には True を返します。

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

構文

deleteMapValue ( tableID As Name, _
                 key As Name ) As Boolean 

引数	[タイプ]	説明
tableID	[名前]	マップの名前です。以前に defineMap() で作成されている必要があります。
key	[名前]	削除するエントリのキーです。

例 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