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

wmemmove()

Copy wide characters from one buffer to another

Synopsis:

#include <wchar.h>

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

Arguments:

ws1
A pointer to where you want the function to copy the data.
ws2
A pointer to the buffer that you want to copy data 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 memmove() function copies n wide characters from the buffer pointed to by ws2 to the buffer pointed to by ws1. This function copies overlapping regions safely.

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


Note: Use wmemcpy() for greater speed when copying buffers that don't overlap.

Returns:

A pointer to the destination buffer (i.e. the same pointed 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() wmemchr(), wmemcmp(), wmemcpy(), wmemset()