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.

See also

• ReadTextFile
• CurrentDataFolder
• Model File Character Encoding