Catégories :

Fonctions de données semi-structurées et structurées (tableau/objet)

ARRAY_PREPEND

Renvoie un tableau contenant le nouvel élément ainsi que tous les éléments du tableau source. Le nouvel élément est positionné au début du tableau.

Voir aussi :

ARRAY_APPEND , ARRAY_INSERT

Syntaxe

ARRAY_PREPEND( <array> , <new_element> )
Copy

Arguments

array

Le tableau source.

new_element

L’élément à ajouter.

Renvoie

Ceci retourne le tableau mis à jour.

Notes sur l’utilisation

  • Lorsque vous transmettez un ARRAY structuré à la fonction, celle-ci renvoie un ARRAY structuré du même type.

  • Si array est un ARRAY structuré, le type du nouvel élément doit être coercible (pouvoir être contraint à se transformer) dans le type du ARRAY.

Exemples

L’exemple ci-dessous montre que l’élément ajouté est placé au début du tableau :

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