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:

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

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

`wrap` will encapsulate rows as embedded tables:

```shell
> 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:

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