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
    <!--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?">

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:

- 644: assigns read/write permission to owner; read permission to group and other.
- 777: assigns read/write/execute permission to all.

OUTPUT |
| Required
String to append to the file.

ADDNEWLINE |
| Optional
Default value: "yes"

- yes: appends newline character to text written to file.
- no

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.

- readOnly
- hidden
- normal

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:

- utf-8
- iso-8859-1
- windows-1252
- us-ascii
- shift_jis
- iso-2022-jp
- euc-jp
- euc-kr
- big5
- euc-cn
- utf-16

For more information character encodings, seewww.w3.org/International/O-charset.html.

FIXNEWLINE |
| Optional
Default value: "No"

- Yes: changes embedded line-ending characters in string variables to operating-system specific line endings
- No: (default) do not change embedded line-ending characters in string variables.

See "cffile action = "write"" for an example that uses this attribute.