append

Inserts an element at the back of a list.

append(xs:list, x:any) -> list

Description

The append function returns the list xs with x inserted at the end. The expression xs.append(x) is equivalent to [...xs, x].

If xs is null, it is treated like an empty list, so null.append(x) returns [x].

from {xs: [1, 2]}
xs = xs.append(3)

{xs: [1, 2, 3]}

from {xs: null}
xs = xs.append(3)

{
  xs: [
    3,
  ],
}