배열 원소 필터링

항목	값
화면 이름	Filter array elements
식별자	`filterArrayElementV1`
지원 실행 방식	Batch, Streaming
범주	배열 (Array)
반환 자료형	`Array<T>`

필터 표현식으로 배열 원소를 선택합니다. 배열 인덱스는 1부터 시작합니다.

입력 인자

이름	지정 여부	자료형	의미와 조건
`Array`	필수	`Expression<Array<T>>`	필터링할 배열입니다.
`Expression to filter`	필수	`Expression<Boolean>`	원소에 대해 표현식이 true이면 남기고 false이면 제거합니다.

자료형 변수의 범위

T는 AnyType 범위의 자료형을 받습니다.

입출력 예시

예시 1: 기본 동작

인자 값:

Array: array
Expression to filter:
isNotNull(
expression: element,
)

array	출력
[ 2, 5, null, 11 ]	[ 2, 5, 11 ]

예시 2: 기본 동작

인자 값:

Array: array
Expression to filter:
lessThanOrEquals(
left: element,
right: 10,
)

array	출력
[ 2, 5, null, 11 ]	[ 2, 5 ]

예시 3: 기본 동작

인자 값:

Array: array
Expression to filter:
lessThanOrEquals(
left: element,
right: 10,
)

array	출력
[ 2, 5, 7, 11, 12, 15 ]	[ 2, 5, 7 ]

예시 4: 기본 동작

배열 인덱스는 1부터 시작합니다.

인자 값:

Array: array
Expression to filter:
equals(
left: element,
right: elementIndex,
)

array	출력
[ 1, -1, -2, 4, -5 ]	[ 1, 4 ]

예시 5: 기본 동작

인자 값:

Array: array
Expression to filter:
stringContains(
expression: element,
ignoreCase: false,
value: hello,
)

array	출력
[ hello world, hello, world ]	[ hello world, hello ]

예시 6: 기본 동작

원소 변수에 Get struct field를 적용하여 구조체 배열을 필드 값으로 필터링합니다.

인자 값:

Array: array
Expression to filter:
lessThanOrEquals(
left:
getStructField(
locator: age,
struct: element,
),
right: 25,
)

array	출력
[ { age: 11, }, { age: 22, }, { age: 33, } ]	[ { age: 11, }, { age: 22, } ]

예시 7: 기본 동작

인자 값:

Array: array
Expression to filter:
lessThanOrEquals(
left:
add(
expressions: [element, 4],
),
right: 10,
)

array	출력
[ 2, 5, 7, 11, 12, 15 ]	[ 2, 5 ]

예시 8: null 처리

인자 값:

Array: array
Expression to filter:
lessThanOrEquals(
left: element,
right: 10,
)

array	출력
null	null