View comments | RSS feed
Contents > CFML Reference > ColdFusion Tags > cffile action = "append" PreviousNext

cffile action = "append"

Appends text to a text file on the server.

<cffile 
   action = "append"
   file = "full_path_name"
   output = "string"
   addNewLine = "Yes" or "No"
   attributes = "file_attributes_list"
   mode = "mode"
   charset = "charset_option" >

cfdirectory

See the History section of the main cffile tag page.

Attribute

Req/Opt

Default

Description

action

Required

 

Type of file manipulation that the tag performs.

file

Required

 

Pathname of the file to which to append content of output attribute.

If not an absolute path (starting a with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory, which is returned by the GetTempDirectory function.

mode

Optional

 

Applies only to UNIX and Linux. Permissions. Octal values of Unix chmod command. Assigned to owner, group, and other, respectively. For example:

  • 644: Assigns read/write permission to owner; read permission to group and other
  • 777: Assigns read/write/execute permission to all

output

Required

 

String to append to the file.

addNewLine

Optional

Yes
  • Yes: appends newline character to text written to file
  • No

attributes

Optional

 

Applies to Windows. A comma-delimited list of attributes to set on the file.

If omitted, the file's attributes are maintained.

Each value must be specified explicitly. For example, if you specify attributes = "readOnly", all other attributes are overwritten.

  • readOnly
  • hidden
  • normal

charset

Optional

JVM default file character set.

The character encoding in which the file contents is encoded. The following list includes commonly used values:

  • utf-8
  • iso-8859-1
  • windows-1252
  • us-ascii
  • shift_jis
  • iso-2022-jp
  • euc-jp
  • euc-kr
  • big5
  • euc-cn
  • utf-16

For more information character encodings, see:
www.w3.org/International/O-charset.html.

This example appends a text string to the file fieldwork.txt: 

<cffile action = "append"
   file = "c:\files\updates\fieldwork.txt" 
output = "<b>But Davis Square is the place to be.</b>">
Contents > CFML Reference > ColdFusion Tags > cffile action = "append" PreviousNext

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Comments


lbryngel said on Feb 18, 2004 at 8:11 AM :
We are working to improve the examples in the ColdFusion reference pages. We propose to replace the current example on this page with the the following example. If you have any comments on this example, add them to this page.

To be consistent with other examples add this section that is also listed in the "write" and "upload" entry:

The following examples show the use of the mode attribute. The first example creates the file /tmp/foo with permissions defined as: owner=read/write, group=read, other=read.

<cffile action = "write"file = "/tmp/foo" mode = 644output = "some text">

This example appends to a file and sets permissions to read/write (rw) for all.

<cffile action = "append" destination = "/home/tomj/testing.txt" mode = 666 output = "Is this a test?">

This example uploads a file and sets permissions to owner/group/other = read/write/execute.

<cffile action = "upload" fileField = "fieldname" destination = "/tmp/program.exe" mode = 777>
IJoeR31673 said on Jun 30, 2004 at 8:13 AM :
can you embed <CFIF> Statements in a CFFILE OUTPUT statement?

If you can then i'd like an example of this...

Thanks
Rob
ocortess said on Jul 20, 2004 at 12:09 PM :
Is it possible to use this tag for saving a form input to Excel? Can we save that Excel File to another server?
Ciphertje said on Jun 1, 2005 at 6:26 AM :
IJoeR31673 considering the fact that output can handle #value# statements i think it will also take <cfif> inside the output=" ">
I havent tested it yet, but noting the date on your post i'm guessing you have.

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/tags-p28.htm