FILE_Append

<< Click to Display Table of Contents >>

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

FILE_Append

 

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

 

See also

 

File Module,

 

Examples