nushell/docs/commands/path_dirname.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

794 B

title layout version
path dirname command 0.59.0

Get the parent directory of a path

Signature

> path dirname --columns --replace --num-levels

Parameters

  • --columns {table}: Optionally operate by column path
  • --replace {string}: Return original path with dirname replaced by this string
  • --num-levels {int}: Number of directories to walk up

Examples

Get dirname of a path

> '/home/joe/code/test.txt' | path dirname

Get dirname of a path in a column

> ls ('.' | path expand) | path dirname -c [ name ]

Walk up two levels

> '/home/joe/code/test.txt' | path dirname -n 2

Replace the part that would be returned with a custom path

> '/home/joe/code/test.txt' | path dirname -n 2 -r /home/viking