drop for filters

Remove items/rows from the end of the input list/table. Counterpart of `skip`. Opposite of `last`.

Signature

> drop (rows)

Parameters

  • rows: The number of items to remove

Input/output types:

inputoutput
list<any>list<any>
tabletable

Examples

Remove the last item of a list

> [0,1,2,3] | drop
╭───┬───╮
│ 00 │
│ 11 │
│ 22 │
╰───┴───╯

Remove zero item of a list

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

Remove the last two items of a list

> [0,1,2,3] | drop 2
╭───┬───╮
│ 00 │
│ 11 │
╰───┴───╯

Remove the last row in a table

> [[a, b]; [1, 2] [3, 4]] | drop 1
╭───┬───┬───╮
│ # │ a │ b │
├───┼───┼───┤
│ 012 │
╰───┴───┴───╯

Subcommands:

nametypeusage
drop columnBuiltinRemove N columns at the right-hand end of the input table. To remove columns by name, use reject.
drop nthBuiltinDrop the selected rows.