- Kategorien:
Funktionen für semistrukturierte und strukturierte Daten (Array/Objekt)
ARRAY_PREPEND¶
Gibt ein Array zurück, das sowohl das neue Element als auch alle Elemente aus dem Quellarray enthält. Das neue Element wird am Anfang des Arrays positioniert.
- Siehe auch:
Syntax¶
ARRAY_PREPEND( <array> , <new_element> )
Argumente¶
array
Das Quellarray.
new_element
Das Element, das vorangestellt werden soll.
Rückgabewerte¶
Gibt das aktualisierte Array zurück.
Nutzungshinweise¶
Wenn Sie der Funktion ein strukturiertes ARRAY übergeben, gibt die Funktion ein strukturiertes ARRAY desselben Typs zurück.
Wenn
array
ein strukturierter ARRAY-Typ ist, muss der Typ des neuen Elements implizit umwandelbar (Koersion) in den ARRAY-Typ sein.
Beispiele¶
Das folgende Beispiel zeigt, dass das vorangegangene Element am Anfang des Arrays platziert wird:
SELECT ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'hello'); +-------------------------------------------------+ | ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'HELLO') | |-------------------------------------------------| | [ | | "hello", | | 0, | | 1, | | 2, | | 3 | | ] | +-------------------------------------------------+