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

wmemcpy()

Copy wide characters from one buffer to another

Synopsis:

#include <wchar.h>

wchar_t * wmemcpy( wchar_t * ws1,
                   const wchar_t * ws2,
                   size_t n );

Arguments:

ws1
A pointer to the buffer that you want to copy the wide characters into.
ws2
A pointer to the buffer that you want to copy the wide characters from.
n
The number of wide characters to copy.

Library:

libc

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

Description:

The wmemcpy() function copies n wide characters from the buffer pointed to by ws2 into the buffer pointed to by ws1.

The wmemcpy() function is locale-independent and treats all wchar_t values identically, even if they're null or invalid characters.


Note: Copying overlapping buffers isn't guaranteed to work; use wmemmove() to copy buffers that overlap.

Returns:

A pointer to the destination buffer (i.e the same pointer as ws1).

Classification:

ANSI, POSIX 1003.1

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

See also:

memccpy(), memcmp(), memcpy(), memicmp(), memmove(), memset() wcscpy(), wcsncpy(), wmemchr(), wmemcmp(), wmemmove(), wmemset()