截断

自 Apache Ant 1.7.1 起

描述

设置一个或多个文件的大小，类似于 truncate Unix 函数或 GNU 工具。除了处理单个文件，此任务还可以处理 资源 和资源集合。

参数

属性 描述 必需
file 文件名称。 除非指定了嵌套的资源集合元素
length 指定要设置的新文件长度（以字节为单位）。支持以下后缀
  • K : 千字节 (1024 字节)
  • M : 兆字节 (1024 K)
  • G : 吉字节 (1024 M)
  • T : 太字节 (1024 G)
  • P : 拍字节 (1024 T)
 最多只能使用其中一个；省略两者意味着 length=0
adjust 指定调整文件长度的字节数（以及正负方向）。此属性支持与 length 属性相同的后缀。
create 是否创建不存在的文件。 否；默认值为 true
mkdirs 是否在创建新文件时创建不存在的父目录。 否；默认值为 false

作为嵌套元素指定的参数

任何资源集合

您可以使用任意数量的嵌套资源集合元素来定义此任务的资源，并引用在其他地方定义的资源。注意：传递给此任务的资源应基于文件系统。

示例

将文件 foo 的长度设置为零。

<truncate file="foo"/>

将文件 foo 的长度设置为 1 千字节 (1024 字节)。

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

将文件 foo 的长度向上调整 1 千字节。

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

将文件 foo 的长度向下调整 1 兆字节。

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