* * HELP & MANUAL PREMIUM PACK 4 DEMO VERSION * *
This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
Description
Output a StringBuffer to a file. Buffer is appended at the end of the current file content.
Syntax
n = FILE_Append(FileName, StringBuffer [, RetryCount])
Returns
Number.
0 means no errors.
Parameters
Name |
Type |
Optional |
Meaning |
FileName |
String |
No |
Name of the file |
StringBuffer |
String |
No |
String to append to file |
RetryCount |
Number |
Yes |
Optional parameter that allows programmer to set a retry count to retry appending text into file in case of run-time error.
If not specified, by default File_Append will retry 5 times before giving up. Or will retry the number of times specified in this parameter |
Remarks
If FileName does not exists it is created.
This function does not append anything other than data found in StringBuffer. In case it is needed some kind of end of line char, please add it to the end of StringBuffer variable.
Restrictions
See also
Examples
