NAME

wcscpy - copy a wide-character string

 SYNOPSIS

#include <wchar.h>

wchar_t *wcscpy(wchar_t *ws1, const wchar_t *ws2);

 DESCRIPTION

The wcscpy() function copies the wide-character string pointed to by ws2 (including the terminating null wide-character code) into the array pointed to by ws1. If copying takes place between objects that overlap, the behaviour is undefined.

 RETURN VALUE

The wcscpy() function returns ws1; no return value is reserved to indicate an error.

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

Wide-character code movement is performed differently in different implementations. Thus overlapping moves may yield surprises.

 FUTURE DIRECTIONS

None.

 SEE ALSO

wcsncpy(), <wchar.h>.

DERIVATION

Derived from the MSE working draft.