Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

wcscpy()

Copy a wide-character string

Synopsis:

#include <wchar.h>

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

Arguments:

ws1
A pointer to where you want to copy the string.
ws2
The wide-character string that you want to copy.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcscpy() function copies the string pointed to by ws2, including the terminating NUL wide character, into the array pointed to by ws1.


Note: This function isn't guaranteed to work properly for copying overlapping strings; use wmemmove() instead.

Returns:

The same pointer as ws1.

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

memmove(), strcpy(), strdup(), strncpy(), wcsncpy(), wmemmove()