切り捨て

Apache Ant 1.7.1以降

説明

Unix関数またはGNUユーティリティのtruncateのように、1つ以上のファイルの長さを設定します。このタスクは単一ファイルだけでなく、リソースやリソースコレクションでも動作します。

パラメータ

属性 説明 必須
ファイル ファイルの名前。 ネストされたリソースコレクション要素が指定されていない限り
長さ 設定する新しいファイルの長さ（バイト単位）を指定します。次のサフィックスはサポートされています
  • K：キロバイト（1024バイト）
  • M：メガバイト（1024 K）
  • G：ギガバイト（1024 M）
  • T：テラバイト（1024 G）
  • P：ペタバイト（1024 T）
 これらはいずれか1つのみです。どちらも省略すると、lengthは= 0になります。
調整 ファイルの長さを調整するバイト数（および方向、プラスまたはマイナス）を指定します。この属性には、length属性と同じサフィックスのサポートが設定されています。
作成 存在しないファイルを作成するかどうかを示します。 いいえ。デフォルトはtrue。
mkdirs 新しいファイルを作成するときに存在しない親ディレクトリを作成するかどうかを示します。 いいえ。デフォルトはfalse。

ネストされた要素として指定されたパラメータ

任意のリソースコレクション

このタスクのリソースを定義し、他の場所で定義されたリソースを参照するために、ネストされたリソースコレクション要素をいくつでも使用できます。注意：このタスクに渡されるリソースは、ファイルシステムベースであることが想定されています。

例

ファイルfooの長さを0に設定します。

<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"/>