自 Apache Ant 1.6.3 起
顯示或設定一個包含字串、檔案或一個或多個巢狀 資源集合 長度資訊的屬性。也可以用作 條件。
| 屬性 | 說明 | 必要 | |
|---|---|---|---|
| 任務 | 條件 | ||
| 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>