take
For filters.
Take only the first n elements of a list, or the first n bytes of a binary value. For binary input, n can also be specified as a filesize.
Command Type
built-in
Signature
> take {flags} (n)
Parameters
n: Starting from the front, the number of elements to return.
Input/output types:
| input | output |
|---|---|
| table | table |
| list<any> | list<any> |
| binary | binary |
| range | list<number> |
Examples
Return the first item of a list/table.
> [1 2 3] | take 1
╭───┬───╮
│ 0 │ 1 │
╰───┴───╯
Return the first 2 items of a list/table.
> [1 2 3] | take 2
╭───┬───╮
│ 0 │ 1 │
│ 1 │ 2 │
╰───┴───╯
Return the first two rows of a table.
> [[editions]; [2015] [2018] [2021]] | take 2
╭───┬──────────╮
│ # │ editions │
├───┼──────────┤
│ 0 │ 2015 │
│ 1 │ 2018 │
╰───┴──────────╯
Return the first 2 bytes of a binary value.
> 0x[01 23 45] | take 2
Length: 2 (0x2) bytes | null_char printable whitespace ascii_other non_ascii
00000000: 01 23 •#
Return the first 3 elements of a range.
> 1..10 | take 3
╭───┬───╮
│ 0 │ 1 │
│ 1 │ 2 │
│ 2 │ 3 │
╰───┴───╯
Return the first 3 bytes of a binary value, using a filesize argument.
> 0x[01 23 45] | take 3b
Length: 3 (0x3) bytes | null_char printable whitespace ascii_other non_ascii
00000000: 01 23 45 •#E
Subcommands:
| name | description | type |
|---|---|---|
take until |
Take elements of the input until a predicate is true. | built-in |
take while |
Take elements of the input while a predicate is true. | built-in |
Ported from nushell/nushell.github.io. Copyright (c) 2021 Nushell Project. MIT License.