界面：地图

rules.Map

接口   静态

地图类型，用于简单的键值对映射。

键必须为 rules.String 类型。

除了下列方法外，地图还具有以下运算符：

---

运算符	用法
x == y	比较地图 x 和 y
x[k]	索引运算符，在键名 k 处获取值
x.k	获取键名 k 的值
k in x	检查映射 x 中是否存在键 k

方法

diff（差异比较）

diff(map_to_compare) 会返回 rules.MapDiff

返回 rules.MapDiff，表示将与 当前 Map 到比较映射。

参数
比较	rules.Map 当前（调用）映射到的 Map 进行比较 值不能为 null。

返回值

表示比较结果的 non-null rules.MapDiff 对象。

get

get(key, default_value) 返回值

返回与给定搜索键值字符串相关联的值。

对于涉及键和子键的嵌套映射，返回值 与给定子键字符串相关联。子键使用 列表中，第一项是顶级键，而最后一项是顶级键 要查询并返回其值的子键。查看嵌套映射 示例。

如果没有与以下内容的匹配项，则该函数需要一个默认值 指定的搜索键值。

参数
键	（非 null rules.String 或非 null rules.List） 指定的一个键 作为字符串；对于嵌套的 Maps，则为使用列表语法指定的子键。
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

密钥

keys() 会返回 rules.List

获取映射中的键列表。

返回值

non-null rules.List 键列表。

大小

size() 会返回 rules.Integer

获取映射中的条目数量。

返回值

non-null rules.Integer 条目数。

值

values() 会返回 rules.List

获取映射中的值列表。

返回值

non-null rules.List 值列表。