nushell/docs/commands/select.md

# select

This command displays only the column names passed on to it.

## Examples

```shell
> ls
━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━
 # │ name                       │ type │ readonly │ size   │ created     │ accessed    │ modified
───┼────────────────────────────┼──────┼──────────┼────────┼─────────────┼─────────────┼─────────────
 0 │ zeusiscrazy.txt            │ File │          │ 556 B  │ a month ago │ a month ago │ a month ago
 1 │ coww.txt                   │ File │          │  24 B  │ a month ago │ a month ago │ a month ago
 2 │ randomweirdstuff.txt       │ File │          │ 197 B  │ a month ago │ a month ago │ a month ago
 3 │ abaracadabra.txt           │ File │          │ 401 B  │ a month ago │ a month ago │ a month ago
 4 │ youshouldeatmorecereal.txt │ File │          │ 768 B  │ a month ago │ a month ago │ a month ago
━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━
> ls | select name
━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 # │ name
───┼────────────────────────────
 0 │ zeusiscrazy.txt
 1 │ coww.txt
 2 │ randomweirdstuff.txt
 3 │ abaracadabra.txt
 4 │ youshouldeatmorecereal.txt
━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

The order in which you put the column names matters:

```shell
> ls | select type name size
━━━┯━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━
 # │ type │ name                       │ size
───┼──────┼────────────────────────────┼────────
 0 │ File │ zeusiscrazy.txt            │ 556 B
 1 │ File │ coww.txt                   │  24 B
 2 │ File │ randomweirdstuff.txt       │ 197 B
 3 │ File │ abaracadabra.txt           │ 401 B
 4 │ File │ youshouldeatmorecereal.txt │ 768 B
━━━┷━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━━━
> ls | select size type name
━━━┯━━━━━━━━┯━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 # │ size   │ type │ name
───┼────────┼──────┼────────────────────────────
 0 │ 556 B  │ File │ zeusiscrazy.txt
 1 │  24 B  │ File │ coww.txt
 2 │ 197 B  │ File │ randomweirdstuff.txt
 3 │ 401 B  │ File │ abaracadabra.txt
 4 │ 768 B  │ File │ youshouldeatmorecereal.txt
━━━┷━━━━━━━━┷━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```
Pick->Select rename. Integration tests changes. (#1725) Pick->Select rename. Integration tests changes. 2020-05-07 13:03:43 +02:00			`# select`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00
			`This command displays only the column names passed on to it.`

			`## Examples`

			```shell
			`> ls`
			`━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━`
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-13 18:23:41 +01:00			`# │ name │ type │ readonly │ size │ created │ accessed │ modified`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`───┼────────────────────────────┼──────┼──────────┼────────┼─────────────┼─────────────┼─────────────`
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-13 18:23:41 +01:00			`0 │ zeusiscrazy.txt │ File │ │ 556 B │ a month ago │ a month ago │ a month ago`
			`1 │ coww.txt │ File │ │ 24 B │ a month ago │ a month ago │ a month ago`
			`2 │ randomweirdstuff.txt │ File │ │ 197 B │ a month ago │ a month ago │ a month ago`
			`3 │ abaracadabra.txt │ File │ │ 401 B │ a month ago │ a month ago │ a month ago`
			`4 │ youshouldeatmorecereal.txt │ File │ │ 768 B │ a month ago │ a month ago │ a month ago`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━`
Pick->Select rename. Integration tests changes. (#1725) Pick->Select rename. Integration tests changes. 2020-05-07 13:03:43 +02:00			`> ls \| select name`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━`
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-13 18:23:41 +01:00			`# │ name`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`───┼────────────────────────────`
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-13 18:23:41 +01:00			`0 │ zeusiscrazy.txt`
			`1 │ coww.txt`
			`2 │ randomweirdstuff.txt`
			`3 │ abaracadabra.txt`
			`4 │ youshouldeatmorecereal.txt`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━`
			```

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-13 18:23:41 +01:00			`The order in which you put the column names matters:`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00
			```shell
Pick->Select rename. Integration tests changes. (#1725) Pick->Select rename. Integration tests changes. 2020-05-07 13:03:43 +02:00			`> ls \| select type name size`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┯━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━`
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-13 18:23:41 +01:00			`# │ type │ name │ size`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`───┼──────┼────────────────────────────┼────────`
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-13 18:23:41 +01:00			`0 │ File │ zeusiscrazy.txt │ 556 B`
			`1 │ File │ coww.txt │ 24 B`
			`2 │ File │ randomweirdstuff.txt │ 197 B`
			`3 │ File │ abaracadabra.txt │ 401 B`
			`4 │ File │ youshouldeatmorecereal.txt │ 768 B`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┷━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━━━`
Pick->Select rename. Integration tests changes. (#1725) Pick->Select rename. Integration tests changes. 2020-05-07 13:03:43 +02:00			`> ls \| select size type name`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┯━━━━━━━━┯━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━`
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-13 18:23:41 +01:00			`# │ size │ type │ name`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`───┼────────┼──────┼────────────────────────────`
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-13 18:23:41 +01:00			`0 │ 556 B │ File │ zeusiscrazy.txt`
			`1 │ 24 B │ File │ coww.txt`
			`2 │ 197 B │ File │ randomweirdstuff.txt`
			`3 │ 401 B │ File │ abaracadabra.txt`
			`4 │ 768 B │ File │ youshouldeatmorecereal.txt`
Add documentation for the pick and reject command Partial fix of issue#711 2019-11-10 08:07:27 +01:00			`━━━┷━━━━━━━━┷━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━`
			```