ThinBASIC Modules > File > FILE: functions working on files > FILE

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. Sometimes on slow or crowded shared/networking file systems appending data into files shared between multiple applications or too frequently append operations can produce run-time errors and text not appended. 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