Appends text to a text file on the server.
<cffile action = "append" file = "full pathname
" output = "string
" addNewLine = "yes|no" attributes = "file attributes list
" charset = "characterset option
" fixnewline = "yes|no" mode = "mode
">
See the History section of the main cffile tag page.
Attribute |
Req/Opt |
Default |
Description |
---|---|---|---|
action |
Required |
|
Type of file manipulation that the tag performs. |
file |
Required |
|
Pathname of the file to which to append content of output attribute. If not an absolute path (starting with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory, which is returned by the GetTempDirectory function. |
output |
Required |
|
String to append to the file. |
addNewLine |
Optional |
yes |
|
attributes |
Optional |
|
Applies to Windows. A comma-delimited list of attributes to set on the file. If omitted, the file's attributes are maintained. Each value must be specified explicitly. For example, if you specify attributes = "readOnly", all other attributes are overwritten.
|
charset |
Optional |
JVM default file character set |
The character encoding in which the file contents is encoded. The following list includes commonly used values:
For more information character encodings, see www.w3.org/International/O-charset.html. |
fixnewline |
Optional |
No |
For an example that uses this attribute, see cffile action = "write". |
mode |
Optional |
|
Applies only to UNIX and Linux. Permissions. Octal values of UNIX chmod command. Assigned to owner, group, and other, respectively; for example:
|
<!--The first example creates the file \temp\foo on a windows system and sets attributes to normal. ---> <cffile action = "write" file = "\temp\foo" attributes = normal output = "some text"> <!--- The second example appends to the file. ---> <cffile action = "append" file = "\temp\foo" attributes = normal output = "Is this a test?">