## Dirname

### Description

Task to determine the directory path of a specified file.

When this task executes, it will set the specified property to the value of the specified file (or directory) up to, but not including, the last path element. If the specified file is a path that ends in a filename, the filename will be dropped. If the specified file is just a filename, the directory will be the current directory.

Note: This is not the same as the UNIX dirname command, which is defined as "strip non-directory suffix from filename". <dirname> determines the full directory path of the specified file.

### Parameters

Attribute | Description | Required
file | The path to take the dirname of. | Yes
property | The name of the property to set. | Yes

### Examples

      <dirname property="antfile.dir" file="/home/kev/workspace/ant-core-171/build.xml"/>

will set `antfile.dir` to the directory path for `/home/kev/workspace/ant-core-171/build.xml`.

      <dirname property="foo.dirname" file="foo.txt"/>

will set `foo.dirname` to the project's basedir.