Skip to main content
Version: v5.0

get

Gets a field from a record or an element from a list

get(x:record, field:string, [fallback:any]) -> any
get(x:record|list, index:number, [fallback:any]) -> any

Description​

The get function returns the record field with the name field or the list element with the index index. If fallback is provided, the function gracefully returns the fallback value instead of emitting a warning and returning null.

Examples​

Get the first element of a list, or a fallback value​

from (
  {xs: [1, 2, 3]},
  {xs: []},
}
select first = xs.get(0, -1)
{first: 1}
{first: -1}

Access a field of a record, or a fallback value​

from (
  {x: 1, y: 2},
  {x: 3},
}
select x = x.get("x", -1), y = y.get("y", -1)
{x: 1, y: 2}
{x: 3, y: -1}