介面:地圖

方法

差異比較

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值的清單。