nushell/docs/commands/append.md

append

Append a row to the table.

Examples

Given the following text file cities.txt containing cities:

Canberra
London
Nairobi
Washington

And getting back a Nu table:

> open cities.txt | lines
───┬────────────
 0 │ Canberra
 1 │ London
 2 │ Nairobi
 3 │ Washington
───┴────────────

Add the city named Beijing like so:

> open cities.txt | lines | append Beijing
───┬────────────
 0 │ Canberra
 1 │ London
 2 │ Nairobi
 3 │ Washington
 4 │ Beijing
───┴────────────

It's not possible to add multiple rows at once, so you'll need to use append multiple times:

> open cities.txt | lines | append Beijing | append "Buenos Aires"
───┬──────────────
 0 │ Canberra
 1 │ London
 2 │ Nairobi
 3 │ Washington
 4 │ Beijing
 5 │ Buenos Aires
───┴──────────────

So far we have been working with a table without a column, which leaves us with plain rows. Let's wrap the plain rows into a column called city and save it as a json file called cities.json:

Before we save, let's check how it looks after wrapping:

open cities.txt | lines | wrap city
───┬────────────
 # │ city
───┼────────────
 0 │ Canberra
 1 │ London
 2 │ Nairobi
 3 │ Washington
───┴────────────

And save:

> open cities.txt | lines | wrap city | save cities.json

Since we will be working with rows that have a column, appending like before won't quite give us back what we want:

> open cities.json | append Guayaquil
───┬────────────
 # │ city
───┼────────────
 0 │ Canberra
 1 │ London
 2 │ Nairobi
 3 │ Washington
───┴────────────
───┬───────────
 4 │ Guayaquil
───┴───────────

We append a row literal directly:

> open cities.json | append [[city]; [Guayaquil]]
───┬────────────
 # │ city
───┼────────────
 0 │ Canberra
 1 │ London
 2 │ Nairobi
 3 │ Washington
 4 │ Guayaquil
───┴────────────