nushell/docs/commands/path_dirname.md
Justin Ma c0a1d18e3d
update #4455, regenerate commands' docs and update make_docs script (#4586)
* feat: update #4455, regenerate commands' docs

* chore: update make_docs script
2022-02-21 11:26:00 -06:00

793 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