连接用于将一个或多个文件连接到单个文件。 如果新文件不存在,则将创建新文件,除非资源列表为空并且ignoreempty
为true
。
从Apache Ant 1.7.1开始,此任务可用作仅返回一个资源的资源集合。
资源集合用于选择要连接的资源。 没有单一属性来指定连接文件的单个资源。
属性 | 描述 | 必需 |
---|---|---|
destfile |
连接流的目标文件 | 否 |
append |
它指定是否应追加destfile 属性指定的文件。 |
否 |
force |
它指定是否应写入destfile 指定的文件。 |
否 |
overwrite |
它指定是否应写入destfile 指定的文件。 |
否 |
forceReadOnly |
它会覆盖只读目标文件。 | 否 |
encoding |
它指定输入文件的编码。 | 否 |
outputencoding |
编写输出文件时使用的编码。 | 否 |
fixlastline |
它指定是否检查每个连接的文件是否被新行终止。 | 否 |
eol |
它指定了fixlastline 属性使用的行尾字符的内容。 |
否 |
binary |
如果此属性设置为true ,则任务以逐字节方式连接文件。 |
否 |
ignoreempty |
指定如果源资源列表为空,是否应创建destfile 指定的文件。 |
否; 默认为true |
resourcename |
指定在将此任务作为资源公开时报告的名称。 | 否 |
将字符串连接到文件:
<concat destfile="README">Hello, World!</concat>
将一系列文件连接到控制台:
<concat> <fileset dir="messages" includes="*important*"/> </concat>