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(3) , <wchar.h> .

DERIVATION

Derived from the MSE working draft.