wcscat Function

Concatenate a wide string with another.

Attention: This function is implemented only by MPLAB XC32 C compilers.

Include

<wchar.h>

Prototype

wchar_t * wcscat( wchar_t * restrict s1, const wchar_t * restrict s2);

Arguments

s1
the wide string to append to
s2
the wide string to append

Return Value

A copy of s1.

Remarks

The function writes a copy of the wide string pointed to by s2 (including the terminating null wide character) to the location of the null wide character at the end of the wide string pointed to by s1.

Example

#include <wchar.h>

int main(void)
{
  wchar_t ws[40] = L"A long";

  wcscat(ws, L" time ago...");
  wprintf(L"the complete wide string is \"%ls\"\n", ws);
}

Example Output

the complete wide string is "A long time ago..."