Next: wmemset, Previous: wmemcpy, Up: Wchar strings [Contents][Index]

### 6.4 `wmemmove`—copy wide characters in memory with overlapping areas

Synopsis

    #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
The `wmemmove` function returns the value of d.

Portability
`wmemmove` is ISO/IEC 9899/AMD1:1995 (ISO C).

No supporting OS subroutines are required.