User Guide

42 Chapter 2: The File I/O API
DWfile.write()
Availability
Dreamweaver 2.
Description
This function writes the specified string to the specified file. If the specified file does not yet exist,
it is created.
Arguments
fileURL
, text, {mode}
• The fileURL argument, which is expressed as a file:// URL, is the file to which you are writing.
• The text argument is the string to be written.
• The mode argument, if it is supplied, must be "append". If this argument is omitted, the
contents of the file are overwritten by the string.
Returns
A Boolean value: true if the string is successfully written to the file; false otherwise.
Example
The following code attempts to write the string "xxx" to the mydata.txt file and displays an alert
message if the write operation succeeds. It then tries to append the string
"aaa" to the file and
displays a second alert if the write succeeds. After executing this script, the mydata.txt file
contains the text
xxxaaa and nothing else.
var fileURL = "file:///c|/temp/mydata.txt";
if (DWfile.write(fileURL, "xxx")){
alert("Wrote xxx to " + fileURL);
}
if (DWfile.write(fileURL, "aaa", "append")){
alert("Appended aaa to " + fileURL);
}
000_DW_API_Print.book Page 42 Wednesday, August 20, 2003 9:14 AM