카테고리:

반정형 및 정형 데이터 함수 (배열/오브젝트)

ARRAY_REMOVE_AT

원본 ARRAY 가 주어지면 지정된 위치에서 요소가 제거된 ARRAY가 반환됩니다.

예를 들어 ARRAY_REMOVE_AT([2, 5, 7], 0) 은 위치 0의 요소를 제거한 ARRAY를 반환합니다([5, 7]).

구문

ARRAY_REMOVE_AT( <array> , <position> )
Copy

인자

array

소스 배열입니다.

position

제거할 요소의 (0을 기준으로 한) 위치입니다. 이 함수는 이 위치에 있는 요소를 제거합니다.

음수 위치는 배열 뒤에서 인덱스로 해석됩니다(예: -1 의 경우, 배열의 마지막 요소가 제거됨).

반환

지정된 위치의 요소를 제거한 ARRAY입니다.

position 이 NULL이면 이 함수는 NULL을 반환합니다.

사용법 노트

  • position 의 절대값이 array 의 길이를 초과하면 이 함수는 어떤 요소도 제거하지 않은 상태로 array 를 반환합니다.

다음 예제에서는 첫 번째 요소를 제거한 요소가 있는 ARRAY를 반환합니다.

SELECT ARRAY_REMOVE_AT(
  [2, 5, 7],
  0);
Copy
+-------------------------------+
| ARRAY_REMOVE_AT([2, 5, 7], 0) |
|-------------------------------|
| [                             |
|   5,                          |
|   7                           |
| ]                             |
+-------------------------------+

다음 예제에서는 마지막 요소를 제거한 요소가 있는 ARRAY를 반환합니다.

SELECT ARRAY_REMOVE_AT(
  [2, 5, 7],
  -1);
Copy
+--------------------------------+
| ARRAY_REMOVE_AT([2, 5, 7], -1) |
|--------------------------------|
| [                              |
|   2,                           |
|   5                            |
| ]                              |
+--------------------------------+

다음 예제에서는 position 이 ARRAY의 길이보다 크므로 이 함수는 어떤 것도 변경하지 않고 ARRAY를 반환합니다.

SELECT ARRAY_REMOVE_AT(
  [2, 5, 7],
  10);
Copy
+------------------+
| ARRAY_REMOVE_AT( |
|   [2, 5, 7],     |
|   10)            |
|------------------|
| [                |
|   2,             |
|   5,             |
|   7              |
| ]                |
+------------------+