Next: wmemset, Previous: wmemcpy, Up: Wchar strings
wmemmove
—copy wide characters in memory with overlapping areasSynopsis
#include <wchar.h> wchar_t *wmemmove(wchar_t *d, const wchar_t *s, size_t n);
Description
The wmemmove
function copies n wide characters from the object
pointed to by s to the object pointed to by d. Copying takes
place as if the n wide characters from the object pointed to by
s are first copied into a temporary array of n wide characters
that does not overlap the objects pointed to by d or s, and then
the n wide characters from the temporary array are copied into the
object pointed to by d.
This function is not affected by locale and all wchar_t values are treated identically. The null wide character and wchar_t values not corresponding to valid characters are not treated specially.
If n is zero, d and s must be a valid pointers, and the function copies zero wide characters.
Returns
wmemmove
function returns the value of d.
Portability
wmemmove
is ISO/IEC 9899/AMD1:1995 (ISO C).
No supporting OS subroutines are required.