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() 함수는 소나 4.0 이전 버전부터 제공되었습니다.