WriteTextFile
What's new in Analytica 4.0? >
WriteTextFile( filename, text, append, warn, sep, showDialog, encoding )
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.
(new to 4.5) «Encoding» specifies the character encoding. Possible values are:
- "ANSI" : One byte per character, ISO-8859-1. Extended characters (above ascii 255) are written as ?.
- "UTF-8" : UTF-8 encoding with a byte order mark (BOM). The UTF-8 encoding uses one byte for comman characters, and 2-3 bytes for characters with ascii values above 127.
- "-UTF-8" : UTF-8 encoding without a BOM.
- "UTF-16" : Two bytes per character, big endian, with BOM.
- "UTF-16le" : Two bytes per character, little endian, with BOM.
Enable comment auto-refresher