Command Prompt for Windows




filecat, _wfilecat, _tfilecat

__int64 filecat(char *dst, char *src, int u_flag);
__int64 _wfilecat(wchar_t *dst, wchar_t *src, int u_flag);
__int64 _tfilecat(TCHAR *dst, TCHAR *src, int u_flag);

Appends the source file to the end of the destination file.

Parameter Description
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.
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.


Returns

On success, it returns the number of bytes appended to the destination file. On error a value of -1 is returned.

Comments

On error, filecat() displays one of the following error messages:-

Out of memory

Invalid path or file name

Destination file already exists

Seek error

Read error

Insufficient disk space

See Also

filesize, filecpy, filencpy, filencat