6.23.32 wcscat Function

Concatenate a wide string with another.

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