valueof()

맵이나 배열에서 지정한 키 또는 인덱스 위치의 값을 반환합니다.

문법

매개변수

COMPOUND

값을 추출할 맵 또는 배열.

KEY

맵에서는 키 문자열, 배열에서는 인덱스 정수.

설명

valueof() 함수는 복합 객체에서 특정 위치의 값을 추출하여 반환합니다.

• COMPOUND가 맵인 경우: KEY에 해당하는 키의 값을 반환합니다.
• COMPOUND가 배열인 경우: KEY를 정수 인덱스로 사용하여 해당 위치의 값을 반환합니다. 인덱스는 0부터 시작합니다.

다음 상황에서 null을 반환합니다.

• COMPOUND 또는 KEY가 null인 경우
• COMPOUND가 맵이나 배열이 아닌 경우
• 배열에 인덱스 값 대신 문자열 키를 지정한 경우
• 맵에 정수 인덱스를 지정한 경우(맵의 키 타입이 정수가 아닌 경우)
• 인덱스가 배열의 유효 범위를 벗어난 경우

오류 코드

해당 사항 없음

사용 예

1. 배열에서 인덱스로 값 추출 (인덱스는 0부터 시작)

   json "{}"
   | eval foods = array("Apple", "Banana", "Cucumber")
   | eval food = valueof(foods, 2)
   | # food: Cucumber
   

2. 맵에서 키로 값 추출

   json "{}"
   | eval foods = dict("a", "Apple", "b", "Banana", "c", "Cucumber")
   | eval food = valueof(foods, "b")
   | # food: Banana
   

3. COMPOUND가 null인 경우

   json "{}" | eval food = valueof(null, "b")
   | # food: null
   

4. 배열 인덱스가 유효 범위를 벗어난 경우

   json "{}"
   | eval foods = array("Apple", "Banana")
   | eval food = valueof(foods, 5)
   | # food: null
   

호환성

valueof() 함수는 소나 4.0 이전 버전부터 제공되었습니다.