Sets a token filter for this project or read multiple token filter from an input file and sets these as filters. Token filters are used by all tasks that perform file copying operations through the Project commodity methods.

プロジェクトに対しトークンフィルタを設定したり、 入力ファイルより複数のトークンフィルタを読み込んで、 これらをフィルタとして設定したりします。 トークンフィルタは、 プロジェクト共通のメソッドにより、 ファイルのコピー操作を行う全てのタスクによって使用されます。

Note 1: the token string must not contain the separators chars (@).
Note 2: Either token and value attributes must be provided, or only the filtersfile attribute.

注意1: トークン文字列には区切り文字(@)を含んではいけません。
注意2: token と value 属性か、もしくは、filtersfile 属性のみか、 いずれか一方を指定しなければなりません。



Attribute Description Required
token the token string without @ Yes*
value the string that should be put to replace the token when the file is copied Yes*
filtersfile The file from which the filters must be read. This file must be a formatted as a property file. Yes*
属性 説明 必須
token @をふくまないトークン文字列 Yes*
value ファイルのコピー時に、 トークンと置換するために指定される文字列 Yes*
filtersfile フィルターを読み込むファイル。 このファイルはプロパティファイルの形式でなければなりません。 Yes*

* 表の上の注意1、および2をご覧ください。


  <filter token="year" value="2000"/>
  <copy todir="${dest.dir}" filtering="true">
    <fileset dir="${src.dir}"/>

この例は、 src.dirディレクトリから dest.dirディレクトリへ、 全ての文字列@year@にマッチする部分を2000に置換しながら、 全てのファイルを再帰的にコピーします。

  <filter filtersfile=""/>

will read all property entries from the file and set these as filters.

この例では、 ファイルの全てのプロパティの項目を読み込み、 これらをフィルターとして設定します。

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

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