first
To return the first item of an array
You can access the first entry of an array with this function. This function comes in handy if you try to access a record in an array of records.
The record IDs of the tables are arranged differently in the multiple platforms. Therefore, different results are displayed according to each platform. This applies if the array consists of records.
If you combine the function with select
and the respective array has more than 1 element, we recommend sorting the array first with order by
.
Syntax
first([any])
Return
any
Examples
first(["B", "A", "C"])
Result: B
first(select Customer)
Result: Returns the first record of the Customer table.
first((select Customer where substr('Last name', 0, 1) = "A") order by 'Last name')
Result: Returns the first record of the table Customer where the last name starts with an A.
See also
last
which returns the last item of an array.
item
which extracts a value of an array or an object.
Do you want to dive deeper into the topic? Take a look at the corresponding part of our video tutorial.