連接用于將一個(gè)或多個(gè)文件連接到單個(gè)文件。 如果新文件不存在,則將創(chuàng)建新文件,除非資源列表為空并且ignoreempty為true。
從Apache Ant 1.7.1開始,此任務(wù)可用作僅返回一個(gè)資源的資源集合。
資源集合用于選擇要連接的資源。 沒有單一屬性來指定連接文件的單個(gè)資源。
| 屬性 | 描述 | 必需 |
|---|---|---|
destfile |
連接流的目標(biāo)文件 | 否 |
append |
它指定是否應(yīng)追加destfile屬性指定的文件。 |
否 |
force |
它指定是否應(yīng)寫入destfile指定的文件。 |
否 |
overwrite |
它指定是否應(yīng)寫入destfile指定的文件。 |
否 |
forceReadOnly |
它會(huì)覆蓋只讀目標(biāo)文件。 | 否 |
encoding |
它指定輸入文件的編碼。 | 否 |
outputencoding |
編寫輸出文件時(shí)使用的編碼。 | 否 |
fixlastline |
它指定是否檢查每個(gè)連接的文件是否被新行終止。 | 否 |
eol |
它指定了fixlastline屬性使用的行尾字符的內(nèi)容。 |
否 |
binary |
如果此屬性設(shè)置為true,則任務(wù)以逐字節(jié)方式連接文件。 |
否 |
ignoreempty |
指定如果源資源列表為空,是否應(yīng)創(chuàng)建destfile指定的文件。 |
否; 默認(rèn)為true |
resourcename |
指定在將此任務(wù)作為資源公開時(shí)報(bào)告的名稱。 | 否 |
將字符串連接到文件:
<concat destfile="README">Hello, World!</concat>
將一系列文件連接到控制臺(tái):
<concat>
<fileset dir="messages" includes="*important*"/>
</concat>