截斷

自 Apache Ant 1.7.1 起

說明

設定一個或多個檔案的長度，如同 Unix 函數或 GNU 工具中的 truncate。除了處理單一檔案外，此任務也可以處理 資源 和資源集合。

參數

屬性 說明 必要
檔案 檔案名稱。 除非已指定巢狀資源集合元素
長度 指定要設定的新檔案長度（以位元組為單位）。支援下列後綴字元
  • K：千位元組（1024 位元組）
  • M：百萬位元組（1024 K）
  • G：十億位元組（1024 M）
  • T：兆位元組（1024 G）
  • P：拍位元組（1024 T）
 這些後綴字元最多只能使用一個；若兩個都省略，表示 長度=0
調整 指定要調整檔案長度的位元組數（以及正負方向）。此屬性支援與 長度 屬性相同的後綴字元。
建立 是否建立不存在的檔案。 否；預設為 true
建立目錄 建立新檔案時，是否建立不存在的父目錄。 否；預設為 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"/>