CFLib.org – Common Function Library Project

FileAppend(file, output[, mode][, addNewLine][, attributes])

Last updated October 15, 2002

author

Raymond Camden

Version: 1 | Requires: CF6 | Library: CFMLLib

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:

Name Description Required
file The file to append. Yes
output The data to append. Yes
mode Defines permissions for a file on non-Windows systems. No
addNewLine If true, a new line character is added to output. No
attributes File attributes. No

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>

Search CFLib.org


Latest Additions

Raymond Camden added
QueryDeleteRows
November 04, 2017

Leigh added
nullPad
May 11, 2016

Raymond Camden added
stripHTML
May 10, 2016

Kevin Cotton added
date2ExcelDate
May 05, 2016

Raymond Camden added
CapFirst
April 25, 2016

Created by Raymond Camden / Design by Justin Johnson