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

ARRAY_PREPEND¶

Retorna uma matriz contendo o novo elemento, bem como todos os elementos da matriz de origem. O novo elemento é posicionado no início da matriz.

Consulte também:: ARRAY_APPEND , ARRAY_INSERT

Sintaxe¶

ARRAY_PREPEND( <array> , <new_element> )

Copy

Argumentos¶

array: A matriz de origem.
new_element: O elemento a ser anexado.

Retornos¶

Isso devolve a matriz atualizada.

Notas de uso¶

Quando você passa uma matriz estruturada para a função, a função retorna uma matriz estruturada do mesmo tipo.
Se array for uma ARRAY estruturada, o tipo do novo elemento deverá ser coercível ao tipo de ARRAY.

Exemplos¶

O exemplo abaixo mostra que o elemento anexado é colocado no início da matriz:

SELECT ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'hello');
+-------------------------------------------------+
| ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'HELLO') |
|-------------------------------------------------|
| [                                               |
|   "hello",                                      |
|   0,                                            |
|   1,                                            |
|   2,                                            |
|   3                                             |
| ]                                               |
+-------------------------------------------------+

Copy