From 753a6c60f47f3ac4f270005b65e9d6481de8eb68 Mon Sep 17 00:00:00 2001
From: Ashlee Young
+Specialization of loadresource that
+works on files exclusively and provides a srcFile attribute for
+convenience. Unless an encoding is specified, the encoding of the
+current locale is used.
+ If the resource content is empty (maybe after processing a filterchain)
+the property is not set.
+The LoadFile task supports nested
+FilterChains.
+
+LoadFile
+Description
+Parameters
+
+
+
+
+ Attribute
+ Description
+ Required
+
+
+ srcFile
+ source file
+ Yes
+
+
+ property
+ property to save to
+ Yes
+
+
+ encoding
+ encoding to use when loading the file
+ No
+
+
+ failonerror
+ Whether to halt the build on failure
+ No, default "true"
+
+
+
+quiet
+ Do not display a diagnostic message (unless Apache Ant has been
+ invoked with the
+ -verbose
or -debug
+ switches) or modify the exit status to reflect an error. Setting this to
+ "true" implies setting failonerror to "false".
+ Since Ant 1.7.0.
+ No, default "false"
+ Examples
+ <loadfile property="message"
+ srcFile="message.txt"/>
+
+Load file message.txt into property "message"; an <echo>
+can print this. This is identical to
+ <loadresource property="message">
+ <file file="message.txt"/>
+ </loadresource>
+
+
<loadfile property="encoded-file" + srcFile="loadfile.xml" + encoding="ISO-8859-1"/> ++Load a file using the latin-1 encoding + +
<loadfile + property="optional.value" + srcFile="optional.txt" + failonerror="false"/> ++Load a file, don't fail if it is missing (a message is printed, though) + +
<loadfile + property="mail.recipients" + srcFile="recipientlist.txt"> + <filterchain> + <striplinebreaks/> + </filterchain> + </loadfile> ++Load a property which can be used as a parameter for another task (in this case mail), +merging lines to ensure this happens. + +
<loadfile + property="system.configuration.xml" + srcFile="configuration.xml"> + <filterchain> + <expandproperties/> + </filterchain> + </loadfile> ++Load an XML file into a property, expanding all properties declared +in the file in the process. + + + + + + + -- cgit 1.2.3-korg