ARRAY_REMOVE

기능

배열에서 지정된 값과 같은 모든 요소를 제거하고 나머지 요소의 상대적인 순서는 유지합니다.

구문

• ARRAY_REMOVE(arr, target)

매개변수

• arr: ARRAY<T> 타입으로, 숫자, boolean, string, datetime, IP, UUID 등을 지원합니다.
• target: 배열 요소와 같은 타입의 값으로, 제거할 요소를 찾는 데 사용합니다.

반환 값

• 입력과 같은 타입의 ARRAY<T>를 반환합니다.
• arr가 NULL이면 NULL을 반환합니다.

사용 시 참고 사항

• 일치 규칙: 값이 target과 같은 요소만 제거합니다. NULL은 NULL과 같습니다.

예제

• 기본: 제거 후에도 남은 요소는 원래의 상대적인 순서를 유지합니다.

  • ARRAY_REMOVE([1,2,3], 1) -> [2,3]
  • ARRAY_REMOVE([1,2,3,null], 1) -> [2,3,null]

• target이 NULL이면 NULL을 arr에서 제거합니다.

  • ARRAY_REMOVE(['a','b','c',NULL], NULL) -> NULL

• arr가 NULL이면 NULL을 반환합니다

  • ARRAY_REMOVE(NULL, 2) -> NULL

• 일치하는 요소가 없는 경우

  • ARRAY_REMOVE([1,2,3], 258) -> [1,2,3]