Move

Description

説明

Moves a file to a new file or directory, or sets of files to a new directory. By default, the destination file is overwritten if it already exists. When overwrite is turned off, then files are only moved if the source file is newer than the destination file, or when the destination file does not exist.

一つのファイルを新しいファイルや、ディレクトリに移動したり、 ファイルの集合を新しいディレクトリに移動したりします。 デフォルトで、 既に移動出力先にファイルが存在する場合、上書きされます。 overwrite属性が off の場合、 ソースファイルが移動先ファイルよりも新しいか、 移動先ファイルが存在しない場合にのみ、ファイルが移動します。

FileSets are used to select sets of files to move to the todir directory.

todirディレクトリへ移動するファイルを選択するために、 FileSetが使われます。

Parameters

パラメータ

Attribute Description Required
file the file to move One of file or at least one nested fileset element
tofile the file to move to With the file attribute, either tofile or todir can be used. With nested filesets, if the fileset size is greater than 1 or if the only entry in the fileset is a directory or if the file attribute is already specified, only todir is allowed
todir the directory to move to
overwrite overwrite existing files even if the destination files are newer (default is "true") No
filtering indicates whether token filtering should take place during the move. See the filter task for a description of how filters work. No
flatten ignore directory structure of source directory, copy all files into a single directory, specified by the todir attribute (default is "false").Note that you can achieve the same effect by using a flatten mapper No
includeEmptyDirs Copy empty directories included with the nested FileSet(s). Defaults to "yes". No
属性 説明 必須
file 移動するファイル 一つのfileあるいは、 少なくとも一つのネストされたfileset要素
tofile 移動先のファイル file属性の場合、 tofiletodirのいずれかが使えます。 ネストされた fileset の場合、 ファイルセットの数が1よりも大きいか、 dir属性のみしか <fileset>属性中で指定されていないか、 file属性も指定されている場合、 todirのみが指定可能です。
todir 移動先ディレクトリ
overwrite コピー先のファイルが新しくても既存のファイルを上書きします。 (デフォルトは"true") No
filtering 移動の際に、トークンフィルタを使うかどうか示します。 フィルタの仕組みについての説明は filterタスクをご覧ください。 No
flatten ソースディレクトリのディレクトリ構造を無視して、 全てのファイルを todir 属性で指定された一つのディレクトリにコピーします。 (デフォルトは "false") flatten mapper を使っても同じ効果が得られることに注意してください。 No
includeEmptyDirs ネストしたfilesetに入っている空のディレクトリをコピーするか。 デフォルトは"yes" No

Parameters specified as nested elements

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

mapper

You can define file name transformations by using a nested mapper element. The default mapper used by <copy> is the identity.

mapper 要素を使うことによりファイル名の変換を定義できます。 <copy>で使われる デフォルトのマッパーは identityです。

filterchain

The Move task supports nested FilterChains.

move タスクは filterchainをネストするのをサポートしています。

Examples

Move a single file (rename a file)

一つのファイルの移動 (一つのファイルの名前の変更)

  <move file="file.orig" tofile="file.moved"/>

Move a single file to a directory

一つのファイルをあるディレクトリに移動

  <move file="file.orig" todir="dir/to/move/to"/>

Move a directory to a new directory

一つのディレクトリを新しいディレクトリに移動

  <move todir="new/dir/to/move/to">
    <fileset dir="src/dir"/>
  </move>

Move a set of files to a new directory

幾つかのファイルを新しいディレクトリに移動

  <move todir="some/new/dir" >
    <fileset dir="my/src/dir" >
      <include name="**/*.jar"/>
      <exclude name="**/ant.jar"/>
    </fileset>
  </move>

Append ".bak" to the names of all files in a directory.

ディレクトリ中の全てのファイルの名前に ".bak" を追加する

  <move todir="my/src/dir" >
    <fileset dir="my/src/dir" >
      <exclude name="**/*.bak"/>
    </fileset>
    <mapper type="glob" from="*" to="*.bak"/>
  </move>

Copyright © 2000-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは漆島賢二が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]