介面：地圖

規則。對應

介面   靜態

用於簡易鍵/值對應的地圖類型。

鍵的類型必須是 rules.String。

除了下列方法以外，地圖還具有下列運算子：

---

運算子	用量
x == y	比較地圖 x 和 y
x[k]	索引運算子，取得鍵名 k 的值
x.k	取得鍵名 k 的值
k in x	檢查對應 x 中是否有索引鍵 k

方法

差異比較

diff(map_to_compare) 會傳回 rules.MapDiff

傳回 rules.MapDiff，代表比較 。

參數
map_to_compare	rules.Map 目前 (呼叫) 的地圖 會用於比較 值不得為空值。

傳回

non-null rules.MapDiff 物件，代表比較結果。

get

get(key, default_value) 傳回 值

傳回與指定搜尋值字串相關聯的值。

如果是巢狀地圖，包含鍵和子鍵，則會傳回值 與指定的子鍵字串建立關聯子鍵可透過 第一個項目是頂層鍵，最後一個項目則是 其值。查看巢狀地圖 範例。

這個函式需要有預設值，才能在沒有符合項目時傳回 找到指定的搜尋值。

參數
金鑰	(非空值 rules.String 或非空值 rules.List) 所指定的是金鑰 做為字串，而對於巢狀地圖，則是使用清單語法指定的子鍵。
default_value	default_value 地圖時要傳回的值 未包含指定的搜尋值。可以是任何規則語言類型。

傳回

value 與指定 key 對應的值，或 如果不相符，則由 default_value 指定的預設傳回值 找到指定的鍵由於地圖內容是由使用者定義，因此資料類型 傳回的 value 可以是任何規則語言類型。

範例

// "c" is not a key in the supplied Map, returns default value 7.
{"a": 3,"b": 2}.get("c", 7) == 7

// Default result can be any type, e.g. a list such as [1, 1].
{"a": [2, 7], "b": [9, 12]}.get("c", [1, 1]) == [1, 1]

// Return a list on a successful match.
{"a": [2, 7],"b": [9, 12]}.get("b", [1, 1]) == [9, 12]

// For nested Maps, use list ["a", "b"] to specify lookup on sub-key "b".
{"a": {"b": 1},"c": 2}.get(["a", "b"], 7) == 1

金鑰

key() 會傳回 rules.List

取得對應中的索引鍵清單。

傳回

non-null rules.List 鍵清單。

大小

size() 會傳回 rules.Integer。

取得對應中的項目數量。

傳回

non-null rules.Integer 個項目。

值

values() 會傳回 rules.List

取得對應值的清單。

傳回

non-null rules.List值的清單。