ルール。地図
単純なキーと値のマッピングに使用されるマップ タイプ。
キーのタイプはrules.String
である必要があります。
以下にリストされているメソッドに加えて、マップには次の演算子があります。
オペレーター | 使用法 |
---|---|
x == y | マップ x と y を比較する |
x[k] | インデックス演算子、キー名 k の値を取得 |
xk | キー名 k の値を取得する |
k in x | キー k がマップ x に存在するかどうかを確認する |
メソッド
差分
diff(map_to_compare) はrules.MapDiffを返します。
現在の Map と比較 Map を比較した結果を表すrules.MapDiffを返します。
パラメータ | |
---|---|
比較する地図 | 現在の (呼び出し元の) Map と比較される Map。 値は null であってはなりません。 |
- 戻り値
比較の結果を表す
non-null rules.MapDiff
オブジェクト。
得る
get(key,default_value) は値を返します
指定された検索キー文字列に関連付けられた値を返します。
ネストされたマップの場合、キーとサブキーが関係し、指定されたサブキー文字列に関連付けられた値を返します。サブキーはリストを使用して識別されます。リストの最初の項目はトップレベルのキーで、最後の項目は値が検索されて返されるサブキーです。以下のネストされたマップの例を参照してください。
この関数では、指定された検索キーに一致するものが見つからなかった場合に返すデフォルト値が必要です。
パラメータ | |
---|---|
鍵 | (null 以外のrules.Stringまたは null 以外のrules.List ) 文字列として指定されたキー、またはネストされたマップの場合はリスト構文を使用して指定されたサブキー。 |
デフォルト値 | デフォルト値 マップに指定された検索キーが含まれていない場合に返される値。任意のルール言語タイプを使用できます。 |
- 戻り値
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
整数のエントリ数。
価値観
value() はrules.Listを返します。
マップ内の値のリストを取得します。
- 戻り値
non-null rules.List
値のリスト。