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> )

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 tableau structuré à la fonction, celle-ci renvoie un tableau 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                                             |
| ]                                               |
+-------------------------------------------------+