Pathconvert

Description

説明

Converts a nested <path> or reference to a Path, FileSet, DirSet, or FileList into a path form for a particular platform, and stores the result in a given property. It can also be used when you need to convert a Path, FileSet, or DirSet into a list, separated by a given character, such as a comma or space, or, conversely, to convert a list of files in a FileList into a path.

ネストされた<path>や、 path、fileset、dirset、または、filelist への参照を特定のプラットフォーム用のパス形式に変換し、結果を与えられたプロパティに保存します。 また、 path、fileset、または dirset を、 カンマや空白文字といった与えられた文字で区切られたリストに変換する必要がある場合にも使えます。 逆に、filelist 中のファイルの一覧をパスに変換したい場合にも使えます。

Nested <map> elements can be specified to map Windows drive letters to Unix paths, and vice-versa.

ネストされた<map>要素は、 Windows のドライブ文字を Unix のパスに、またその逆にマッピングするために指定されます。

Parameters

パラメータ

Attribute Description Required
targetos The target architecture. Must be one of 'unix', 'windows', 'netware' or 'os/2'. This is a shorthand mechanism for specifying both pathsep and dirsep according to the specified target architecture. Yes, unless pathsep and/or dirsep are specified.
dirsep The character(s) to use as the directory separator in the generated paths. No, defaults to current JVM File.separator
pathsep The character(s) to use as the path-element separator in the generated paths. No, defaults to current JVM File.pathSeparator
property The name of the property in which to place the converted path. Yes
refid What to convert, given as a reference to a <path>, <fileset>, <dirset>, or <fileset> defined elsewhere No; if omitted, a nested <path> element must be supplied.
setonempty Should the property be set, even if the result is the empty string? No; default is "true".
属性 説明 必須
targetos ターゲットのアーキテクチャ。 'unix'、'windows'、'netware' または 'os/2' のいずれか一つでなければならない。 与えられたターゲットアーキテクチャに従った、 pathsep および dirsep の双方を指定するメカニズムの省略形です。 pathsep および/または dirsepが指定されない限りは Yes
dirsep 生成されたパスのディレクトリ区分記号として使われる文字 No、デフォルトは現在のJVM のFile.separator
pathsep 生成されたパスのパス要素区分記号として使われる文字 No、デフォルトは現在のJVM のFile.pathSeparator
property 変換されたパスが置かれるプロパティ名 Yes
refid 別の場所で定義された、 <path><fileset><dirset>または<fileset> への参照として与えられる 変換対象 No; 省略された場合、 ネストされた<path>要素を与えなければならない
setonempty 結果が空文字列であったとしても、プロパティを設定するか No; デフォルトは "true".

Parameters specified as nested elements

ネストされる要素で指定されるパラメータ

map

Specifies the mapping of path prefixes between Unix and Windows.

Unix と Windows の間のパス接頭辞のマッピングを指定します。

Attribute Description Required
from The prefix to match. Note that this value is case-insensitive when the build is running on a Windows platform and case-sensitive when running on a Unix platform. Yes
to The replacement text to use when from is matched. Yes
属性 説明 必須
from パターンマッチのための接頭辞。 この値は Windows プラットフォーム上で、 ビルドを実行する場合には大文字小文字を区別せず、 Unix プラットフォーム上で実行する場合には、 大文字小文字を区別します。 Yes
to fromがマッチした場合に使われる置換文字列 Yes

Each map element specifies a single replacement map to be applied to the elements of the path being processed. If no map entries are specified, then no path prefix mapping is performed.

個々の map 要素は、 処理されるパスの要素に適用される一つの置換マッピングを指定します。 map エントリが指定されなかった場合、 パス接頭辞マッピングは何も行われません。

Note: The map elements are applied in the order specified, and only the first matching map element is applied. So, the ordering of your map elements can be important, if any from values are prefixes of other from values.

注意: map 要素は指定された順序で適用され、 最初にマッチした map 要素のみが適用されます。 ですから、 ある from の値が、他のfromの値の接頭辞だった場合に、 map 要素の順序は重要となることがあります。

path

If the refid attribute is not specified, then a nested <path> element must be supplied. See Path-like Structures for details.

refid 属性が指定されなかった場合、 ネストされた<path>要素を必ず与えなければなりません。 詳しくはパス類似構造をご覧ください。

Examples

In the examples below, assume that the ${wl.home} property has the value d:\weblogic, and ${wl.home.unix} has the value /weblogic.

下の例では、 プロパティ ${wl.home} が 値 d:\weblogic を持ち、 ${wl.home.unix}/weblogic を持つとしています。

Example 1

例 1

    <path id="wl.path">
      <pathelement location="${wl.home}/lib/weblogicaux.jar"/>
      <pathelement location="${wl.home}/classes"/>
      <pathelement location="${wl.home}/mssqlserver4/classes"/>
      <pathelement location="c:\winnt\System32"/>
    </path>
    
    <pathconvert targetos="unix" property="wl.path.unix" refid="wl.path">
      <map from="${wl.home}" to="${wl.home.unix}"/>
      <map from="c:" to=""/>
    </pathconvert>

will generate the path shown below and store it in the property named wl.path.unix.

これは、下で示されるパスを生成し、 wl.path.unixという名前のプロパティに保存されます。

/weblogic/lib/weblogicaux.jar:/weblogic/classes:/weblogic/mssqlserver4/classes:/WINNT/SYSTEM32

Example 2

例 2

Given a FileList defined as:

あるファイルリストが次のように定義されているとします:

  <filelist id="custom_tasks.jars"
        dir="${env.HOME}/ant/lib"
        files="njavac.jar,xproperty.jar"/>

then:

すると:

    <pathconvert targetos="unix" property="custom_tasks.jars" refid="custom_tasks.jars">
      <map from="${env.HOME}" to="/usr/local"/>
    </pathconvert>

will convert the list of files to the following Unix path:

これはファイルのリストを次の Unix パスに変換します:

/usr/local/ant/lib/njavac.jar:/usr/local/ant/lib/xproperty.jar

Example 3

例 3

    <fileset dir="${src.dir}" id="src.files">
      <include name="**/*.java"/>
    </fileset>
  
    <pathconvert pathsep="," property="javafiles" refid="src.files"/>

This example takes the set of files determined by the fileset (all files ending in .java), joins them together separated by commas, and places the resulting list into the property javafiles. The directory separator is not specified, so it defaults to the appropriate character for the current platform. Such a list could then be used in another task, like javadoc, that requires a comma separated list of files.

この例では、 ファイルセット(.javaで終る全てのファイル) により定義されるファイルの集合を取り、 カンマで区切ってそれを一つに繋げ、 結果のリストをプロパティjavafilesに置きます。 ディレクトリ区分記号は指定されていないので、 カレントプラットフォームの適切な文字をデフォルトに取ります。 そして、このようなりストは、 javadocといった、 カンマで区切られたファイルのリストを必要とする別のタスクで使われるでしょう。


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

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