nushell/docs/commands/path_join.md
JT 8c0a2d3c15
Auto-generate markdown command docs (#4451)
* Finish updating

* a couple improvements

* Update renames

* cleanup examples
2022-02-13 21:22:51 -05:00

40 lines
685 B
Markdown

---
title: path join
layout: command
version: 0.59.0
---
Join a structured path or a list of path parts.
## Signature
```> path join (append) --columns```
## Parameters
- `append`: Path to append to the input
- `--columns {table}`: Optionally operate by column path
## Examples
Append a filename to a path
```shell
> '/home/viking' | path join spam.txt
```
Append a filename to a path inside a column
```shell
> ls | path join spam.txt -c [ name ]
```
Join a list of parts into a path
```shell
> [ '/' 'home' 'viking' 'spam.txt' ] | path join
```
Join a structured path into a path
```shell
> [[ parent stem extension ]; [ '/home/viking' 'spam' 'txt' ]] | path join
```