rules. マップ
単純な Key-Value マッピングに使用されるマップタイプ。
キーは rules.String
型にする必要があります。
下記のメソッドに加えて、マップには次の演算子があります。
演算子 | 用途 |
---|---|
x == y |
マップ x と y を比較する |
x[k] |
インデックス演算子、キー名 k の値を取得 |
x.k |
キー名 k の値を取得 |
k in x |
キー k がマップ x に存在するかどうかを確認する |
メソッド
差分
diff(map_to_compare) は rules.MapDiff を返します。
比較の結果を表す rules.MapDiff を返します。 現在のマップを比較マップに変換します。
パラメータ |
|
---|---|
比較対象のマッピング |
現在の(呼び出し元の)Map が参照される Map 比較されます。 値を null にすることはできません。 |
- 戻り値
-
比較の結果を表す
non-null rules.MapDiff
オブジェクト。
get
get(key, default_value) は値を返します。
指定した検索キー文字列に関連付けられた値を返します。
ネストされたマップの場合、キーとサブキーを含むが、値を返します。 サブキー文字列に 1 つずつ関連付けられています。サブキーは、 最初のアイテムが最上位キーで、最後のアイテムが その値が検索されて返されるサブキーです。ネストされたマップを表示する 見てみましょう。
関数には、一致するものがない場合に返されるデフォルト値が必要です。 特定の検索キーが見つかった場合は 検索キーを返します
パラメータ |
|
---|---|
key |
(非 null の rules.String または null 以外の 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
鍵
keys() は rules.List を返します。
マップ内のキーのリストを取得します。
- 戻り値
-
non-null rules.List
のキーのリスト。
サイズ
size() は rules.Integer を返します。
マップ内のエントリ数を取得します。
- 戻り値
-
non-null rules.Integer
エントリ数。
values
values() は rules.List を返します。
マップ内の値のリストを取得します。
- 戻り値
-
non-null rules.List
の値のリスト。