ファイルをネイティブエンコーディングからエスケープされたUnicodeを含むASCIIに変換します。一般的な用途は、ネイティブオペレーティングシステムのエンコーディングで管理されているソースファイルを、コンパイル前にASCIIに変換することです。
ディレクトリ src 内のファイルは、ネイティブエンコーディングからASCIIに変換されます。デフォルトでは、ディレクトリ内のすべてのファイルが変換されます。ただし、includes 属性と excludes 属性を使用して、変換を選択したファイルに制限できます。ファイルマッチングパターンの詳細については、ディレクトリベースのタスクのセクションを参照してください。 encoding が指定されていない場合、JVMのデフォルトエンコーディングが使用されます。 ext が指定されている場合、出力ファイルの名前が変更され、新しい拡張子として使用されます。ネストされた <mapper> 要素を使用すると、より高度なファイル名変換を実現できます。デフォルトでは、アイデンティティマッパーが使用されます。 dest と src が同じディレクトリを指している場合、ext 属性またはネストされた <mapper> が必要です。
このタスクは暗黙的な FileSet を形成し、<fileset> のほとんどの属性（dir は src になります）と、ネストされた <include>、<exclude>、および <patternset> 要素をサポートします。
異なるコンバーターを使用することが可能です。これは、implementation 属性またはネストされた要素で選択できます。属性の選択肢は次のとおりです。
default—プラットフォームのデフォルトコンバーター：Kaffeで実行する場合はkaffe、それ以外の場合はbuiltin。
sun—JDK 8以前の標準コンバーターでした
kaffe—Kaffeの標準コンバーター
builtin—Antの内部実装。 Ant 1.9.8以降
| 属性 | 説明 | 必須 |
|---|---|---|
| reverse | 変換の意味を逆にする、つまりASCIIからネイティブに変換するsunおよび builtinコンバーターでのみサポートされています |
いいえ |
| encoding | ファイルのネイティブエンコーディング | いいえ; デフォルトはJVMのデフォルト文字エンコーディング |
| src | ファイルを探すディレクトリ; デフォルトは basedir | いいえ |
| dest | ファイルを出力するディレクトリ | はい |
| ext | 出力ファイルの名前変更に使用するファイル拡張子 | いいえ |
| includes | 含める必要があるファイルのパターンをカンマまたはスペースで区切ったリスト。 | いいえ; デフォルトはすべて（**） |
| includesfile | ファイルの名前。このファイルの各行はインクルードパターンと見なされます | いいえ |
| excludes | 除外する必要があるファイルのパターンをカンマまたはスペースで区切ったリスト。 | いいえ; デフォルトはデフォルトの除外、defaultexcludes が noの場合はなし |
| excludesfile | ファイルの名前。このファイルの各行は除外パターンと見なされます | いいえ |
| defaultexcludes | デフォルトの除外を使用するかどうかを示します（yes|no）。 |
いいえ; デフォルトは yes |
| implementation | 使用するコンバーター実装。（上記の有効なコンバーターのリストを参照してください。） | いいえ; デフォルトは現在のJVMのデフォルトコンバーター |
ネストされた <arg> 要素を使用して、コンバーターに追加のコマンドライン引数を指定できます。これらの要素はコマンドライン引数のように指定されますが、指定されたコンバーター実装が使用される場合にのみ引数を有効にするために使用できる追加の属性があります。
| 属性 | 説明 | 必須 |
|---|---|---|
| value | コマンドライン引数を参照してください。 | これらのうち1つだけ |
| line | ||
| file | ||
| path | ||
| implementation | 選択されたコンバーター実装がこの属性の値と一致する場合にのみ、指定された引数を渡します。有効な値は、上記の有効なコンパイラのリストと同じです。） | いいえ |
Apache Ant 1.8.0以降
カスタムクラスが指定されている場合にコンバーター実装をロードするときに使用するクラスパスを保持するパスのような構造。組み込みコンバーターのいずれかを使用する場合、効果はありません。
Ant 1.8.0以降
定義された型が Native2AsciiAdapter インターフェースを実装する場合、その型のネストされた要素を implementation 属性の代わりに使用できます。
ディレクトリ srcdir 内の .eucjis で終わるすべてのファイルをEUCJISエンコーディングからASCIIに変換し、.java で終わるように名前を変更します。
<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir"
includes="**/*.eucjis" ext=".java"/>
ディレクトリ native/japanese 内の .java で終わるすべてのファイルをASCIIに変換し、結果をディレクトリ src に配置します。ファイルの名前は変わりません。
<native2ascii encoding="EUCJIS" src="native/japanese" dest="src"
includes="**/*.java"/>
カスタム Native2AsciiAdapter org.example.MyAdapter を使用する場合、implementation属性を使用できます
<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir"
includes="**/*.eucjis" ext=".java"
implementation="org.example.MyAdapter"/>
または、型を定義し、これをタスクにネストします
<componentdef classname="org.example.MyAdapter"
name="myadapter"/>
<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir"
includes="**/*.eucjis" ext=".java">
<myadapter/>
</native2ascii>
この場合、native2ascii アダプターは独自の属性とネストされた要素をサポートできます。