規則。 對應
用於簡易鍵/值對應的地圖類型。
鍵的類型必須是 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 |
目前 (呼叫) 的地圖 會用於比較 值不得為空值。 |
- 傳回
-
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
值的清單。