Merge commit '35dec7c96f7ee3eb17dd444f7067f0c776fb56ae'

This commit is contained in:
Bjørn Erik Pedersen
2023-12-04 15:24:01 +01:00
810 changed files with 24147 additions and 7766 deletions

View File

@@ -1,36 +1,27 @@
---
title: path.Dir
description: Dir returns all but the last element of a path.
categories: [functions]
description: Replaces path separators with slashes (/) and returns all but the last element of the given path.
categories: []
keywords: []
menu:
docs:
parent: functions
function:
action:
aliases: []
related:
- functions/path/Base
- functions/path/BaseName
- functions/path/Clean
- functions/path/Ext
- functions/path/Join
- functions/path/Split
returnType: string
signatures: [path.Dir PATH]
relatedFunctions:
- path.Base
- path.BaseName
- path.Clean
- path.Dir
- path.Ext
- path.Join
- path.Split
aliases: [/functions/path.dir]
---
`path.Dir` returns all but the last element of `PATH`, typically `PATH`'s directory.
The returned path will never end in a slash.
If `PATH` is empty, `.` is returned.
**Note:** On Windows, `PATH` is converted to slash (`/`) separators.
```go-html-template
{{ path.Dir "a/news.html" }} → "a"
{{ path.Dir "news.html" }} → "."
{{ path.Dir "a/b/c" }} → "a/b"
{{ path.Dir "/x/y/z" }} → "/x/y"
{{ path.Dir "a/news.html" }} → a
{{ path.Dir "news.html" }} → .
{{ path.Dir "a/b/c" }} → a/b
{{ path.Dir "/a/b/c" }} → /a/b
{{ path.Dir "/a/b/c/" }} → /a/b/c
{{ path.Dir "" }} → .
```