Parameter
Last updated on
Oct 27, 2023
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
|
|
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.