mirror of
https://github.com/opentffoundation/opentf.git
synced 2025-12-21 10:47:34 -05:00
a15a6c9657
Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com> Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com> Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
40 lines
1.4 KiB
Plaintext
40 lines
1.4 KiB
Plaintext
---
|
|
sidebar_label: dirname
|
|
description: The dirname function removes the last portion from a filesystem path.
|
|
---
|
|
|
|
# `dirname` Function
|
|
|
|
`dirname` takes a string containing a filesystem path and removes the last
|
|
portion from it.
|
|
|
|
This function works only with the path string and does not access the
|
|
filesystem itself. It is therefore unable to take into account filesystem
|
|
features such as symlinks.
|
|
|
|
If the path is empty then the result is `"."`, representing the current
|
|
working directory.
|
|
|
|
The behavior of this function depends on the host platform. On Windows systems,
|
|
it uses backslash `\` as the path segment separator. On Unix systems, the slash
|
|
`/` is used. The result of this function is normalized, so on a Windows system
|
|
any slashes in the given path will be replaced by backslashes before returning.
|
|
|
|
Referring directly to filesystem paths in resource arguments may cause
|
|
spurious diffs if the same configuration is applied from multiple systems or on
|
|
different host operating systems. We recommend using filesystem paths only
|
|
for transient values, such as the argument to [`file`](../../language/functions/file.mdx) (where
|
|
only the contents are then stored) or in `connection` and `provisioner` blocks.
|
|
|
|
## Examples
|
|
|
|
```
|
|
> dirname("foo/bar/baz.txt")
|
|
foo/bar
|
|
```
|
|
|
|
## Related Functions
|
|
|
|
* [`basename`](../../language/functions/basename.mdx) returns _only_ the last portion of a filesystem
|
|
path, discarding the portion that would be returned by `dirname`.
|