dict()

キーと値のペアリストを受け取りマップ（オブジェクト）を生成して返します。

構文

パラメーター

KEY1, VALUE1, KEY2, VALUE2, ...

キーと値をペアで指定します。引数を省略すると空のマップを返します。キーは文字列でなければならず、値はすべての型を使用できます。引数の数は偶数でなければなりません。

説明

dict() 関数はキーと値のペアのリストを受け取りマップを生成して返します。キーが文字列でない場合は当該ペアはマップに含まれません。同じキーを複数回指定すると後から指定した値が使用されます。引数の数が奇数の場合はクエリのパース時にエラーが発生します。

エラーコード

使用例

1. 空のマップを生成

   json "{}" | eval result = dict()
   | # result: {}
   

2. 文字列キーと値のペアでマップを生成

   json "{}" | eval result = dict("name", "alice", "age", 30)
   | # result: {"name":"alice","age":30}
   

3. 様々な型の値でマップを生成

   json "{}" | eval result = dict("host", ip("192.0.2.1"), "ports", array(80, 443))
   | # result: {"host":"192.0.2.1","ports":[80,443]}
   

4. null 入力（キーが null の場合は当該ペアを除外）

   json "{'val': null}" | eval result = dict(val, "skip", "key", "value")
   | # result: {"key":"value"}
   

互換性

dict() 関数はSonar 4.0以前のバージョンから提供されています。