You're looking at documentation for Terraform v1.1 and earlier. Click here to view the latest content.
A new platform for documentation and tutorials is launching soon.
We are migrating Terraform documentation into HashiCorp Developer, our new developer experience.
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
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
only the contents are then stored) or in
> dirname("foo/bar/baz.txt") foo/bar
basenamereturns only the last portion of a filesystem path, discarding the portion that would be returned by