Skip to main content Skip to complementary content

ELEMENT_AT

Retrieves the element of an array at a given index.

Syntax

ELEMENT_AT(ARRAY(E), INDEX)

Arguments

ARRAY(E)

Type: array

A array of values of any type.

INDEX

Type: integer

An integer indicating the index of the element to retrieve.

If INDEX > 0, this function provides the same functionality as the SQL-standard subscript operator ([]).

If INDEX < 0, this function accesses elements from the last to the first.

Note that if the ARRAY contains any null values, they are ignored in the indexing of the array.

Returns

Type: same as input

The element of ARRAY at the given INDEX.

Note that if the INDEX is 0, then the function returns null.


Examples

ARRAY INDEX Output
[5,2,3,1,2,3] 1 5
[5,2,3,1,2,3] 4 1
[5,2,3,1,2,3] 10 NULL
[5,2,3,1,6,3] -2 6
[a,2,p,34] 3 p

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!