forked from extern/nushell
5ca9e12b7f
* 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
29 lines
972 B
Markdown
29 lines
972 B
Markdown
# lines
|
|
This command takes a string from a pipeline as input, and returns a table where each line of the input string is a row in the table. Empty lines are ignored. This command is capable of feeding other commands, such as `nth`, with its output.
|
|
|
|
## Usage
|
|
```shell
|
|
> [input-command] | lines
|
|
```
|
|
|
|
## Examples
|
|
Basic usage:
|
|
```shell
|
|
> printf "Hello\nWorld!\nLove, nushell." | lines
|
|
━━━┯━━━━━━━━━━━━━━━━
|
|
# │ value
|
|
───┼────────────────
|
|
0 │ Hello
|
|
1 │ World!
|
|
2 │ Love, nushell.
|
|
━━━┷━━━━━━━━━━━━━━━━
|
|
```
|
|
|
|
One useful application is piping the contents of file into `lines`. This example extracts a certain line from a given file.
|
|
```shell
|
|
> cat lines.md | lines | nth 6
|
|
## Examples
|
|
```
|
|
|
|
Similarly to this example, `lines` can be used to extract certain portions of or apply transformations to data returned by any program which returns a string.
|