Write text to file (2 ways)

SyncJS actually does offer 2 distinct functions to write text to file:

function AppendTextToFile(filename, text: string): boolean;
function WriteTextToFile(filename, text: string): boolean;

Both of these functions write text to a file and return true if the operation was successful, otherwise they return false. Also, both functions automatically create the file if it doesn’t exist.

The main difference is that the AppendTextToFile function will append text at the end of a file (if it exists) whereas the WriteTextToFile will overwrite whatever contents are already in a file with the specified text, and all pre-existing file content will be lost.

Both functions support escaped strings, so, for example, if you want to write a sentence and then a NEWLINE special control character, you can simply add \n to the text to be written to file. String escaping follows this convention.

This function accepts the following parameters:

Parameter Type Requirement Explanation
filename string required must be a valid and existing path to a file you wish to write into
text string required the text string you want to write to the file

Possible return values:

Value Explanation
true the function succeeded: the text was written into the file
true the function failed: the file was not written/modified

Example

{
  AppendTextFile('/home/someuser/docs/somefile.txt', 'Hello world!\n');
}