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 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 | | ] | +-------------------------------------------------+ 
Copy