Difference between revisions of "WriteTextFile"

m
m
Line 7: Line 7:
 
= WriteTextFile( filename, text'', append, warn, sep, showDialog'' ) =
 
= WriteTextFile( filename, text'', append, warn, sep, showDialog'' ) =
  
Writes data to a text file.
+
Writes text to a file with name filename.
 +
 
 +
If the file exists, and append is true, it appends the text to the file. If it doesn't exist, it asks whether to create it.
 +
If append is false, and the file exists, if warn is true, it gives a warning to ask if you want to overwrite the file.
 +
If
  
 
(new to 4.0) The optional «showDialog» flag controls whether the file dialog displays.  If not specified, then the dialog appears if the indicated filename is a directory, a read-only file, or if it exists and warn is true.  When «showDialog» is true, the dialog displays, using the indicated filename as a default value but allowing the user to change it.  When false, the dialog is suppressed in all cases (usually meaning an error is issued instead).
 
(new to 4.0) The optional «showDialog» flag controls whether the file dialog displays.  If not specified, then the dialog appears if the indicated filename is a directory, a read-only file, or if it exists and warn is true.  When «showDialog» is true, the dialog displays, using the indicated filename as a default value but allowing the user to change it.  When false, the dialog is suppressed in all cases (usually meaning an error is issued instead).
Line 15: Line 19:
 
Setting «warn» to false suppresses the warning about the file already existing.
 
Setting «warn» to false suppresses the warning about the file already existing.
  
«sep» is used as a line separator when «text» contains multiple array entries.
+
It uses «sep» as a line separator between elements when «text» is an array.
 +
 
 +
If «showdialog» is true, it always opens a dialog before creating the file, so user can change file name and select folder. If false, it suppresses the dialog in all cases.
  
 
= See also =
 
= See also =

Revision as of 02:41, 28 February 2010


What's new in Analytica 4.0? >

WriteTextFile( filename, text, append, warn, sep, showDialog )

Writes text to a file with name filename.

If the file exists, and append is true, it appends the text to the file. If it doesn't exist, it asks whether to create it. If append is false, and the file exists, if warn is true, it gives a warning to ask if you want to overwrite the file. If

(new to 4.0) The optional «showDialog» flag controls whether the file dialog displays. If not specified, then the dialog appears if the indicated filename is a directory, a read-only file, or if it exists and warn is true. When «showDialog» is true, the dialog displays, using the indicated filename as a default value but allowing the user to change it. When false, the dialog is suppressed in all cases (usually meaning an error is issued instead).

Setting «append» to true appends to the end of an existing file.

Setting «warn» to false suppresses the warning about the file already existing.

It uses «sep» as a line separator between elements when «text» is an array.

If «showdialog» is true, it always opens a dialog before creating the file, so user can change file name and select folder. If false, it suppresses the dialog in all cases.

See also

Comments


You are not allowed to post comments.