CFLib.org – Common Function Library Project

Description:
Mimics the cffile, action="append" command.

Return Values:
Does not return a value.

Example:

<cfscript>
//fileAppend("c:\neotestingzone\udf\cfml\foo.txt","Ray was here","","Yes");
</cfscript>

Parameters:

Full UDF Source:

<!---
 Mimics the cffile, action=&quot;append&quot; command.
 
 @param file      The file to append. (Required)
 @param output      The data to append. (Required)
 @param mode      Defines permissions for a file on non-Windows systems. (Optional)
 @param addNewLine      If true, a new line character is added to output. (Optional)
 @param attributes      File attributes. (Optional)
 @return Does not return a value. 
 @author Raymond Camden (ray@camdenfamily.com) 
 @version 1, October 15, 2002 
--->
<cffunction name="fileAppend" output="false" returnType="void">
    <cfargument name="file" type="string" required="true">
    <cfargument name="output" type="string" required="true">
    <cfargument name="mode" type="string" default="" required="false">
    <cfargument name="addNewLine" type="boolean" default="yes" required="false">
    <cfargument name="attributes" type="string" default="" required="false">
    <cfif mode is "">
        <cffile action="append" file="#file#" output="#output#" addNewLine="#addNewLine#" attributes="#attributes#">    
    <cfelse>
        <cffile action="append" file="#file#" output="#output#" mode="#mode#" addNewLine="#addNewLine#" attributes="#attributes#">    
    </cfif>
</cffunction>