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

40 lines
793 B
Markdown

---
title: path dirname
layout: command
version: 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
```shell
> '/home/joe/code/test.txt' | path dirname
```
Get dirname of a path in a column
```shell
> ls ('.' | path expand) | path dirname -c [ name ]
```
Walk up two levels
```shell
> '/home/joe/code/test.txt' | path dirname -n 2
```
Replace the part that would be returned with a custom path
```shell
> '/home/joe/code/test.txt' | path dirname -n 2 -r /home/viking
```