path.BaseName
Returns the last element of the given path with its extension removed, if present.
- Syntax
- path.BaseName PATH
- Returns
- string
Usage
The path.BaseName function returns the last element of the given path with its extension removed, if present. The extension is the suffix that begins at the final dot in the last element, as returned by the path.Ext function. The function removes only that suffix, so a last element such as .gitignore produces an empty string.
The function removes trailing slashes before it extracts the last element.
On Windows, the function first replaces each backslash (\) in its arguments with a slash (/).
Examples
{{ path.BaseName "a/news.html" }} → news
{{ path.BaseName "news.html" }} → news
{{ path.BaseName "a/b/c" }} → c
{{ path.BaseName "/x/y/z/" }} → zLast elements that contain more than one dot or begin with a dot:
{{ path.BaseName "archive.tar.gz" }} → archive.tar
{{ path.BaseName ".gitignore" }} → "" (empty string)Empty paths and paths that contain only slashes:
{{ path.BaseName "" }} → .
{{ path.BaseName "/" }} → /Last updated:
November 12, 2026
:
content: Apply style guide to path functions (0fd00f291)
Improve this page