連線用於將一個或多個檔案連線到單個檔案。 如果新檔案不存在,則將建立新檔案,除非資源列表為空並且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>