WriteTextFile
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 end of 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. Setting «warn» to False
, suppresses the warning about the file already existing.
The optional «showDialog» flag controls whether the file dialog displays. If not specified, then the dialog appears if the indicated filename is a folder, a read-only file, or if it exists and «warn» is True
. When «showDialog» parameter is True
, it always opens a dialog before creating the file, so user can change file name and select folder -- 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).
WriteTextFile uses «sep» as a line separator between elements when «text» is an array.
(new to Analytica 4.5) «encoding» parameter 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.
History
Introduced in Analytica 4.0.
Enable comment auto-refresher