CFLib.org – FileAppend

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

Last updated October 15, 2002

Download UDF

author

Raymond Camden
Send Email

Version: 1 | Requires: ColdFusion MX | Library: CFMLLib

Rated 1 time(s). Average Rating: 5.0

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

Return Values:
Does not return a value.

Example:

view plain print about

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

<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:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<!---
 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 (&#114;&#97;&#121;&#64;&#99;&#97;&#109;&#100;&#101;&#110;&#102;&#97;&#109;&#105;&#108;&#121;&#46;&#99;&#111;&#109;) 
 @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>
		<!---
 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>