CFLib.org – Common Function Library Project

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

Last updated October 15, 2002
Download UDF

author

Raymond Camden                                    Raymond Camden

Version: 1 | Requires: ColdFusion MX | 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

Jose Diaz-Salcedo Jose Diaz-Salcedo added
cfRssFeed
2 day(s) ago

Raymond Compton Raymond Compton added
structBlend
23 day(s) ago

Duncan Duncan added
IsZIPUK
23 day(s) ago

Todd Sharp Todd Sharp added
getTagContentAll
29 day(s) ago

Gerald Guido Gerald Guido added
ListReturnDuplicat...
1 month(s) ago

Created by Raymond Camden / Design by Justin Johnson