prepend for filters

Prepend any number of rows to a table.

Signature

> prepend (row)

Parameters

• row: the row, list, or table to prepend

Notes

Be aware that this command 'unwraps' lists passed to it. So, if you pass a variable to it, and you want the variable's contents to be prepended without being unwrapped, it's wise to pre-emptively wrap the variable in a list, like so: prepend [$val]. This way, prepend will only unwrap the outer list, and leave the variable's contents untouched.

Examples

Prepend one Int item

> [1,2,3,4] | prepend 0
╭───┬───╮
│ 0 │ 0 │
│ 1 │ 1 │
│ 2 │ 2 │
│ 3 │ 3 │
│ 4 │ 4 │
╰───┴───╯

Prepend two Int items

> [2,3,4] | prepend [0,1]
╭───┬───╮
│ 0 │ 0 │
│ 1 │ 1 │
│ 2 │ 2 │
│ 3 │ 3 │
│ 4 │ 4 │
╰───┴───╯

Prepend Ints and Strings

> [2,nu,4,shell] | prepend [0,1,rocks]
╭───┬───────╮
│ 0 │     0 │
│ 1 │     1 │
│ 2 │ rocks │
│ 3 │     2 │
│ 4 │ nu    │
│ 5 │     4 │
│ 6 │ shell │
╰───┴───────╯