subList() function

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

subList(<key>, <start_index, inclusive>, <end_index, exclusive>) 함수는 이벤트의 리스트 필드에서 부분 리스트(sublist)를 추출해요. 이 함수는 다음 인자를 받아요:

이 함수는 지정된 시작 인덱스와 끝 인덱스 사이에 해당하는 리스트의 부분을 반환해요. 끝 인덱스가 -1이면, 함수는 시작 인덱스부터 리스트 끝까지의 요소를 추출해요.

다음 예제들은 sublist() 함수가 어떻게 동작하는지 보여줘요.

다음 예제에서 보듯이, add_entries 프로세서에서 subList()를 사용할 수 있어요.

함수는 다음 입력을 사용해 부분 리스트를 추출해요:

input: {"my_list": [ 0, 1, 2, 3, 4, 5, 6]}

그다음, 다음 설정은 add_entries 프로세서를 사용해 my_list에서 인덱스 1부터 시작해서 인덱스 4 앞에서 끝나는 부분 리스트를 추출해요:

add_entries:
  entries:
    - key: "my_list"
      value_expression: '/subList(/my_list, 1, 4)'
      overwrite_if_key_exists: true

{% include copy.html %}

다음 출력은 인덱스 1부터 3까지의 요소를 추출하고 원본 리스트를 덮어쓴 후의 결과 리스트를 보여줘요:

output: my_list: [1, 2, 3]

다음 각 예제는 subList() 함수가 리스트에서 특정 범위의 요소를 어떻게 추출하는지 보여줘요.

다음 예제는 인덱스 0부터 2까지(인덱스 3은 제외)의 요소를 추출해서 리스트의 처음 세 요소를 결과로 만들어요:

{
  "event": {
    "/my_list": [0, 1, 2, 3, 4, 5, 6]
  },
  "expression": "subList(/my_list, 4, -1)",
  "expected_output": [4, 5, 6]
}

{% include copy.html %}

다음 예제는 끝 인덱스로 -1을 사용하는데, 이는 인덱스 4부터 리스트 끝까지의 모든 요소를 포함하도록 지정하는 거예요:

{
  "event": {
    "/my_list": [0, 1, 2, 3, 4, 5, 6]
  },
  "expression": "subList(/my_list, 4, -1)",
  "expected_output": [4, 5, 6]
}

{% include copy.html %}