Name

pathconvert

Synopsis

Converts Ant paths, or filesets, into platform-specific paths, storing the result in a property.

Attributes

dirsep (1.4, String, *)

The character used as a directory separator, such as ":“. Defaults to File.separator on the current JVM.

pathsep (1.4, String, *)

The character used as a path separator, such as "/“. Defaults to File.pathSeparator on the current JVM.

property (1.4, String, Y)

The property in which to store the converted path.

refid (1.4, Reference, *)

A reference to the path to convert.

targetos (1.4, String, *)

A shortcut for defining both pathsep and dirsep. Legal values are unix and windows. dirsep and pathsep values are then chosen in conformance with specified operating systems.

Must specify either targetos or both dirsep and pathsep. Either the refid attribute or a nested <path> element is required.

Content

0..n nested <map> elements (1.4)

Each specifies the mapping of path prefixes between Unix and Windows. Ant applies only the first matching <map> element. Following are the valid <map> attributes in this context.

from (1.4, String, Y)

The prefix to map, such as C:. This is case-insensitive when Ant runs on Windows, and case-sensitive when Ant runs on Unix.

to (1.4, String, Y)

The replacement to use when from matches — for example, /usr.

0,1 nested <path> elements (1.4)

A path element used in place of the refid attribute.

Example Usage

The following example defines a fileset:

<fileset id="sources1" dir="src" includes="**/*.java" excludes="**/test/**/*.java"/> ...

Get Ant: The Definitive Guide now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.