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

 C_FILEAPPEND()

 DESCRIPTION

 C_FILEAPPEND() copies the contents of a given file to another
 specified file.  The entire source file is appended to the target
 file leaving the source file unchanged.  The size of the buffer
 used during the append can be optionally specified.

 NOTES

 Both the source and target files must be closed before calling this
 function.

 SYNTAX

 C_FILEAPPEND(source_file, target_file [,bufsize] [,network])

 PARAMETERS

 source_file (C) is the name of the source file to append.  The
 contents of source_file will be appended to the target file leaving
 this file unchanged.  The complete file name including drive and
 path can be specified.  If a drive and path are not given, the file
 is assumed to be in the current directory.

 target_file (C) is the name of the target file to append.  The
 contents of the source file are appended to this file, thus
 concatenating the two files.  If target_file does not exist, it
 will be created.  The complete file name including drive and path
 can be specified.  If a drive and path are not specified, the file
 is assumed to be in the current directory or if it does not exist
 will be created in the current directory.

 bufsize (N) is the size of the buffer in bytes to use during the
 append from 1 to 64,000.  The larger the buffer size, the faster
 the append will be performed.  If bufsize is not specified, the
 default size of 4096 will be used.  Note that a bufsize of 4096
 bytes performs a fairly fast copy and is usually available in the
 application.

 network (L) indicates whether or not the program is running on a
 network.  If the program is running on a network pass true (.T.) so
 the file can be opened with the proper share access, otherwise pass
 false (.F.).  If network is not specified, the default of false
 (.F.) is used.

 RETURNS

 C_FILEAPPEND() returns a code indicating the status as follows:

 RETURN CODE        DESCRIPTION
 -----------        -----------
 0                  Successful append
 1                  Source file not found
 2                  Error opening target file
 3                  Can not allocate memory
 4                  Error during append

 EXAMPLES

 && Append the file "data.txt" to file "header.txt"
 && "header.txt" will contain all data from both files
 c_fileappend("data.txt","header.txt")