Command Prompt for Windows




filencat, _wfilencat, _tfilencat

__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.

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


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

Out of range

Seek error

Read error

Insufficient disk space

See Also

filesize, filecpy, filencpy, filecat