wcscpy - copy wide character string

Syntax	#include <wchar.h> wchar_t *wcscpy(wchar_t *ws1, const wchar_t *ws2);
	wcscpy() copies the wide character string ws2, including the terminating null wide character code (\0), into the memory area pointed to by ws1. The space pointed to by ws1 must be large enough to accommodate the wide character string ws2 as well as the terminating null wide character code (\0).
Return val.	Pointer to the resulting wide character string ws1.
Notes	Wide character strings terminated with the null wide character code (\0) are expected as arguments. wcscpy() does not verify whether ws1 is large enough to accommodate the result. The behavior is undefined if memory areas overlap. Restriction This version of the C runtime system only supports 1-byte characters as wide character codes. They are of type wchar_t (see stddef.h). (End)
See also	wcsncpy(), wchar.h.