nushell/docs/commands/format.md
2019-12-02 11:02:59 -08:00

1.3 KiB

format

Format columns into a string using a simple pattern

Syntax: format <pattern>

Parameters

  • <pattern>: the pattern to match

Example

Let's say we have a table like this:

> open pets.csv
━━━┯━━━━━━━━━━━┯━━━━━━━━┯━━━━━
 # │ animal    │ name   │ age
───┼───────────┼────────┼─────
 0 │ cat       │ Tom    │ 7
 1 │ dog       │ Alfred │ 10
 2 │ chameleon │ Linda  │ 1
━━━┷━━━━━━━━━━━┷━━━━━━━━┷━━━━━

format allows us to convert table data into a string by following a formatting pattern. To print the value of a column we have to put the column name in curly brackets:

> open pets.csv | format "{name} is a {age} year old {animal}"
━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 # │ <value>
───┼─────────────────────────────────
 0 │ Tom is a 7 year old cat
 1 │ Alfred is a 10 year old dog
 2 │ Linda is a 1 year old chameleon
━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━