ssCore.FileSys.appendToFileUTF16

Appends the data to the end of a unicode text file without overwriting existing data.


Availability:

First available in version 3.0 build 2039.


Input Parameters:

path - A fully qualified path to a file. This parameter supports monikers.

writeBOM - [Optional] - If the file is being created, write the BOM (byte order marker) at the beginning of the file. Valid values include: true,false. Default value is true.

bigEndian - [Optional] - Write to the file in big-endian byte order. Valid values include: false,true. Default value is false.

data - Data to be added to the end of the file.


Output Parameters:

No output parameters.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.FileSys.appendToFileUTF16( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.FileSys.appendToFileUTF16( paramsObject );


Notes:

The data will be added to the end of the file. You can use FileSys.writeToFileUTF16 to overwrite the contents of an existing file.

If the specified file does not exist it will be created. FileSys.appendToFileUTF16 will not create folders that are part of the path, so the target folder must exist (see FileSys.createDir).

                

Examples:

ssCore.FileSys.appendToFileUTF16({path:"startdir://file.txt", data:"Data added to a file.\r\n"});