CFFILE ACTION = "APPEND" | |
Description | |
Appends text to a text file on the server. | |
Syntax<cffile action = "append" file = "full_path_name" output = "string" addNewLine = "Yes" or "No" attributes = "file_attributes_list" mode = "mode" charset = "charset_option" > |
|
See also | |
cfdirectory | |
History | |
See the History section of the main cffile tag page. | |
Example | |
This example appends a text string to the file fieldwork.txt:
<cffile action = "append" file = "c:\files\updates\fieldwork.txt" output = "<b>But Davis Square is the place to be.</b>"> |
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 a 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. |
MODE | |
Optional | |
Applies only to UNIX and Linux. Permissions. Octal values of Unix chmod command. Assigned to owner, group, and other, respectively. For example:
|
OUTPUT | |
Required | |
String to append to the file. |
ADDNEWLINE | |
Optional | |
Default value: "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 | |
Default value: "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. |