Whatever message this page gives is out now! Go check it out!
FileAppend
Last update:
May 18, 2026
Description
Appends text or contents of an object to an in-memory text file.
You can also use this function as an alternative to the cffile tag with the action="append" attribute.
Returns
Void.
Category
Function Syntax
FileAppend(file, data[, charset, addNewLine])See also
History
ColdFusion (2018 release) Update 4, ColdFusion (2016 release) Update 11: Added support for this function.
Parameters
Parameter | Required (Yes/No) | Description |
file | Yes | An absolute path to an on-disk or in-memory text file on the server. |
data | Yes | The file object or string from which to read. |
charset | No | The character encoding in which the file contents is encoded. The following list includes commonly used values:
|
addNewLine | No | Boolean value that indicates whether a new line is to be added to the contents of the file. |
Example
<cfscript>
theDir=GetDirectoryFromPath(GetCurrentTemplatePath())
theFolder=theDir & "file.txt"
fileData="The quick brown fox jumps over the lazy dog."
FileAppend(file=theFolder,data=fileData,charset="UTF-8",addNewLine="yes")
</cfscript>In the snippet above, the parameter addNewLine adds the information that is specified in the parameter data. As many times you run this snippet, the information gets added as a new line in the output file.
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
