Categorias:: Funções de dados semiestruturados e estruturados (Matriz/objeto)

ARRAY_REMOVE_AT¶

Dada uma fonte ARRAY, retorna uma ARRAY com o elemento na posição especificada removido.

Por exemplo, ARRAY_REMOVE_AT([2, 5, 7], 0) retorna uma ARRAY com o elemento na posição 0 removido ([5, 7]).

Sintaxe¶

ARRAY_REMOVE_AT( <array> , <position> ) 

Copy

Argumentos¶

array

A matriz de origem.

position

A posição (baseada em zero) do elemento a ser removido. A função remove o elemento nessa posição.

Uma posição negativa é interpretada como um índice da parte de trás da matriz (por exemplo, -1 remove o último elemento da matriz).

Retornos¶

Uma ARRAY com o elemento na posição especificada removido.

Se position for NULL, a função retornará NULL.

Notas de uso¶

Se o valor absoluto de position exceder o comprimento de array, a função retornará array sem nenhum elemento removido.

Exemplos¶

O exemplo a seguir retorna uma ARRAY com elementos com o primeiro elemento removido.

SELECT ARRAY_REMOVE_AT( [2, 5, 7], 0); 

Copy

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

O exemplo a seguir retorna uma ARRAY com elementos com o último elemento removido.

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

Copy

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

No exemplo a seguir, position é maior que o comprimento de ARRAY, portanto, a função retorna ARRAY sem fazer nenhuma alteração.

SELECT ARRAY_REMOVE_AT( [2, 5, 7], 10); 

Copy

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