prepend for filters

Prepend any number of rows to a table.

Signature

> prepend (row)

Parameters

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

Input/output types:

inputoutput
anylist<any>

Examples

prepend a list to an item

> 0 | prepend [1 2 3]
╭───┬───╮
│ 01 │
│ 12 │
│ 23 │
│ 30 │
╰───┴───╯

Prepend a list of strings to a string

> "a" | prepend ["b"]
╭───┬───╮
│ 0 │ b │
│ 1 │ a │
╰───┴───╯

Prepend one integer item

> [1 2 3 4] | prepend 0
╭───┬───╮
│ 00 │
│ 11 │
│ 22 │
│ 33 │
│ 44 │
╰───┴───╯

Prepend two integer items

> [2 3 4] | prepend [0 1]
╭───┬───╮
│ 00 │
│ 11 │
│ 22 │
│ 33 │
│ 44 │
╰───┴───╯

Prepend integers and strings

> [2 nu 4 shell] | prepend [0 1 rocks]
╭───┬───────╮
│ 00 │
│ 11 │
│ 2 │ rocks │
│ 32 │
│ 4 │ nu    │
│ 54 │
│ 6 │ shell │
╰───┴───────╯

Prepend a range

> [3 4] | prepend 0..2
╭───┬───╮
│ 00 │
│ 11 │
│ 22 │
│ 33 │
│ 44 │
╰───┴───╯

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.