Click above to get retro games delivered to your door ever month!

 C_FILEWRITE()

 DESCRIPTION

 C_FILEWRITE() writes a given character string to a specified file
 and appends a new-line character after the string.  The character
 string is written at the current file pointer position.

 NOTES

 This function is an extension of Clipper's low-level file
 functions.  Clipper's function FOPEN() can be used to open the DOS
 file and obtain the file handle needed for this function.

 SYNTAX

 C_FILEWRITE(handle, string)

 PARAMETERS

 handle (N) is the file handle to write.

 string (C) is the character string to write to the specified file.

 RETURNS

 C_FILEWRITE() returns the number of bytes written to the file
 excluding the new-line character.  If a zero (0) is returned by
 C_FILEWRITE() this indicates that the string was null ("") or an
 error occurred.

 EXAMPLES

 s1 = "Write this string to the file"

 f1 = fopen("DATA.TXT")    && Open the file

 c_filewrite(f1,s1)        && Writes string s1 to file handle f1