__int64 filencat(char *dst, char *src, __int64 num, __int64 offset, int u_flag); __int64 _wfilencat(wchar_t *dst, wchar_t *src, __int64 num, __int64 offset, int u_flag); __int64 _tfilencat(TCHAR *dst, TCHAR *src, __int64 num, __int64 offset, int u_flag);
Appends a part of the source file to the end of the destination file.
|dst||Address of a NULL terminated character string containing the path of the destination file. This path can be relative or absolute and can NOT contain wildcard characters.|
|src||Address of a NULL terminated character string containing the path of the source file. This path can be relative or absolute and can NOT contain wildcard characters.|
|num||Value specifying the number of bytes in the source file that should be appended to the destination file. A value of -1 indicates that all the remaining bytes in the source file, taking into account the starting offset, should be appended.|
|offset||Value specifying an offset into the source file, where characters will be read from, The first byte in the source file is located at offset zero.|
|u_flag||Value which specifies how to update the status bar percentage. These values are #defined in the WOIO.H header file and include:-
INC_BYTE Increment by the size of the source file.
INC_ONE Increment by a value of 1 only.
INC_NONE Do not update.
On success, it returns the number of bytes appended to the destination file. On error a value of -1 is returned.
On error, filecat() displays one of the following error messages:-
Out of memory
Invalid path or file name
Destination file already exists
Out of range
Insufficient disk space