path join for path

Join a structured path or a list of path parts.

Signature

> path join ...rest

Parameters

  • ...rest: Path to append to the input

Input/output types:

inputoutput
list<string>string
recordstring
stringstring
tablelist<string>

Examples

Append a filename to a path

> '/home/viking' | path join spam.txt
/home/viking/spam.txt

Append a filename to a path

> '/home/viking' | path join spams this_spam.txt
/home/viking/spams/this_spam.txt

Join a list of parts into a path

> [ '/' 'home' 'viking' 'spam.txt' ] | path join
/home/viking/spam.txt

Join a structured path into a path

> { parent: '/home/viking', stem: 'spam', extension: 'txt' } | path join
/home/viking/spam.txt

Join a table of structured paths into a list of paths

> [[ parent stem extension ]; [ '/home/viking' 'spam' 'txt' ]] | path join
╭───┬───────────────────────╮
│ 0 │ /home/viking/spam.txt │
╰───┴───────────────────────╯

Notes

Optionally, append an additional path to the result. It is designed to accept the output of 'path parse' and 'path split' subcommands.