自 Apache Ant 1.6.3 起
显示或设置一个包含字符串、文件或一个或多个嵌套 资源集合 的长度信息的属性。也可以用作 condition。
| 属性 | 描述 | 必需 | |
|---|---|---|---|
| 任务 | 条件 | ||
| property | 要设置的属性。 | 否；默认情况下，将输出值到日志 | 忽略 |
| mode | 文件长度模式；当为 all时，结果值是所有包含资源长度的总和；当为 each时，任务会输出每个包含资源的绝对路径和长度，每行一个。 |
否；默认值为 all |
|
| file | 要报告长度的单个文件。 | 这些之一，或一个或多个嵌套文件集 | |
| resource | 要报告长度的单个资源（使用扩展的 属性处理）。自 Ant 1.8.1 起 | ||
| string | 要报告长度的字符串。 | ||
| trim | 是否在对字符串进行操作时进行修剪。 | 否；默认值为 false，除非设置了 string，否则将被忽略 |
|
| length | 比较长度。 | 忽略 | 是 |
| when | 比较类型：equal、 eq、 greater、 gt、 less、 lt、 ge（大于或等于）、 ne（不等于）、 le（小于或等于）。 |
否；默认值为 equal |
|
您可以通过嵌套的 资源集合 来包含资源。
将字符串 foo
的长度存储在名为 length.foo 的属性中。
<length string="foo" property="length.foo"/>
将文件 bar 的长度存储在名为 length.bar 的属性中。
<length file="bar" property="length.bar"/>
将 foo 和 bar 的文件路径及其长度存储到属性 length 中。
<length property="length" mode="each">
<fileset dir="." includes="foo,bar"/>
</length>
将 foo 和 bar 的长度相加，并将结果存储到属性 length 中。
<length property="length" mode="all">
<fileset dir="." includes="foo,bar"/>
</length>