strcat

This macro concatenates two strings. It appends the src string to the end of the dest string, and then returns a pointer to the dest string. This macro behaves like the strcat function in the ANSI C string library.

Syntax:

char *strcat (dest, src)
char *dest, *src;

where:

dest                       A character pointer, that specifies the starting address for the destination memory area. Characters from the src string will be appended to the end of this string, starting where the NUL character previously terminated the string.

src                        A character pointer that specifies the source memory area from which to begin copying characters when appending to the end of the dest string.

Return Value

char*                     Points to the first byte in memory associated with the first character of the dest string.

Rules

This macro does not check to see whether the second string will fit in the first array, unless it is a debugger array. Failure to allocate enough space for the first array causes excess characters to overflow into adjacent memory locations. Consider using the strlen macro first to confirm that there is enough length in dest, for the original dest and src together.