nushell/docs/commands/wrap.md

wrap

Wraps data in a table

Syntax: wrap <column>

Parameters

• column: the (optional) name of the column the data should be stored in.

Examples

wrap will give a name to a column of <value> data:

> ls | get name
───┬──────────────
 # │
───┼──────────────
 0 │ americas.csv
 1 │ iso.csv
───┴──────────────

> ls | get name | wrap filename
───┬──────────────
 # │ filename
───┼──────────────
 0 │ americas.csv
 1 │ iso.csv
───┴──────────────

wrap will encapsulate rows as embedded tables:

> ls | select name type size
───┬──────────────┬──────┬─────────
 # │ name         │ type │ size
───┼──────────────┼──────┼─────────
 0 │ americas.csv │ File │   317 B
 1 │ iso.csv      │ File │ 20.8 KB
───┴──────────────┴──────┴─────────

> ls | select name type size | each {wrap details}
───┬────────────────
 # │ details
───┼────────────────
 0 │ [table 1 rows]
 1 │ [table 1 rows]
───┴────────────────

wrap will encapsulate a whole table as an embedded table:

> ls | wrap files
───────┬────────────────
 files │ [table 2 rows]
───────┴────────────────