nushell/docs/commands/nth.md
Waldir Pimenta 5ca9e12b7f
Fix whitespace and typos (#1481)
* Remove EOL whitespace in files other than docs

* Break paragraphs into lines

See http://rhodesmill.org/brandon/2012/one-sentence-per-line/ for the rationale

* Fix various typos

* Remove EOL whitespace in docs/commands/*.md
2020-03-14 06:23:41 +13:00

3.4 KiB

nth

This command returns the nth row of a table, starting from 0. If the number given is less than 0 or more than the number of rows, nothing is returned.

Usage

> [input-command] | nth <row number>  ...args

Parameters:

  • <row number> the number of the row to return
  • args: Optionally return more rows

Examples

> ls
━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━
 # │ name       │ type      │ readonly │ size   │ accessed      │ modified
───┼────────────┼───────────┼──────────┼────────┼───────────────┼───────────────
 0 │ Cargo.toml │ File      │          │ 239 B  │ 2 minutes ago │ 2 minutes ago
 1 │ .git       │ Directory │          │ 4.1 KB │ 2 minutes ago │ 2 minutes ago
 2 │ .gitignore │ File      │          │  19 B  │ 2 minutes ago │ 2 minutes ago
 3 │ src        │ Directory │          │ 4.1 KB │ 2 minutes ago │ 2 minutes ago
━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━

> ls | nth 0
━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━
 # │ name       │ type      │ readonly │ size   │ accessed      │ modified
───┼────────────┼───────────┼──────────┼────────┼───────────────┼───────────────
 0 │ Cargo.toml │ File      │          │ 239 B  │ 2 minutes ago │ 2 minutes ago
━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━

> ls | nth 0 2
━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━
 # │ name       │ type      │ readonly │ size   │ accessed      │ modified
───┼────────────┼───────────┼──────────┼────────┼───────────────┼───────────────
 0 │ Cargo.toml │ File      │          │ 239 B  │ 2 minutes ago │ 2 minutes ago
 2 │ .gitignore │ File      │          │  19 B  │ 2 minutes ago │ 2 minutes ago
━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━

> ls | nth 5