## Truncate

### Description

Set the length of one or more files, as the intermittently available `truncate` Unix utility/function. In addition to working with a single file, this Task can also work on resources and resource collections. Since Apache Ant 1.7.1.

### Parameters

Attribute | Description | Required
file | The name of the file. | Unless a nested resource collection element has been specified.

length

Specifies the new file length (in bytes) to set. The following suffixes are supported:

- K : Kilobytes (1024 bytes)
- M : Megabytes (1024 K)
- G : Gigabytes (1024 M)
- T : Terabytes (1024 G)
- P : Petabytes (1024 T)

At most one of these. Omitting both implies `length="0"`.

adjust | Specifies the number of bytes (and positive/negative direction) by which to adjust file lengths. The same suffixes are supported for this attribute as for the `length` attribute.
create | Whether to create nonexistent files. | No, default true.
mkdirs | Whether to create nonexistent parent directories when creating new files. | No, default false.

### Parameters specified as nested elements

#### any resource collection

You can use any number of nested resource collection elements to define the resources for this task and refer to resources defined elsewhere. Note: resources passed to this task are expected to be filesystem-based.

### Examples

      <truncate file="foo" />

Sets the length of file `foo` to zero.

      <truncate file="foo" length="1K" />

Sets the length of file `foo` to 1 kilobyte (1024 bytes).

      <truncate file="foo" adjust="1K" />

Adjusts the length of file `foo` upward by 1 kilobyte.

      <truncate file="foo" adjust="-1M" />

Adjusts the length of file `foo` downward by 1 megabyte.