mirror of
https://github.com/nushell/nushell
synced 2024-12-27 13:33:16 +00:00
Merge pull request #965 from sebastian-xyz/patch-3
Add prepend command documentation
This commit is contained in:
commit
bcecd08825
1 changed files with 56 additions and 0 deletions
56
docs/commands/prepend.md
Normal file
56
docs/commands/prepend.md
Normal file
|
@ -0,0 +1,56 @@
|
||||||
|
# prepend
|
||||||
|
This command prepends the given row to the front of the table
|
||||||
|
|
||||||
|
**Note**:
|
||||||
|
- `prepend` does not change a file itself. If you want to save your changes, you need to run the `save` command
|
||||||
|
- if you want to add something containing a whitespace character, you need to put it in quotation marks
|
||||||
|
|
||||||
|
## Examples
|
||||||
|
|
||||||
|
Let's complete this table with the missing continents:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
> open continents.txt | lines
|
||||||
|
━━━┯━━━━━━━━━━━━━━━
|
||||||
|
# │ <value>
|
||||||
|
───┼───────────────
|
||||||
|
0 │ Africa
|
||||||
|
1 │ South America
|
||||||
|
2 │ Australia
|
||||||
|
3 │ Europe
|
||||||
|
4 │ Antarctica
|
||||||
|
━━━┷━━━━━━━━━━━━━━━
|
||||||
|
```
|
||||||
|
|
||||||
|
You can add a new row at the top by using `prepend`:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
> open continents.txt | lines | prepend Asia
|
||||||
|
━━━┯━━━━━━━━━━━━━━━
|
||||||
|
# │ <value>
|
||||||
|
───┼───────────────
|
||||||
|
0 │ Asia
|
||||||
|
1 │ Africa
|
||||||
|
2 │ South America
|
||||||
|
3 │ Australia
|
||||||
|
4 │ Europe
|
||||||
|
5 │ Antarctica
|
||||||
|
━━━┷━━━━━━━━━━━━━━━
|
||||||
|
```
|
||||||
|
|
||||||
|
It's not possible to add multiple rows at once, so you'll need to call `prepend` multiple times:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
> open continents.txt | lines | prepend Asia | prepend "North America"
|
||||||
|
━━━┯━━━━━━━━━━━━━━━
|
||||||
|
# │ <value>
|
||||||
|
───┼───────────────
|
||||||
|
0 │ North America
|
||||||
|
1 │ Asia
|
||||||
|
2 │ Africa
|
||||||
|
3 │ South America
|
||||||
|
4 │ Australia
|
||||||
|
5 │ Europe
|
||||||
|
6 │ Antarctica
|
||||||
|
━━━┷━━━━━━━━━━━━━━━
|
||||||
|
```
|
Loading…
Reference in a new issue