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

### 6.5 `wmempcpy`—copy wide characters in memory and return end pointer

Synopsis

    #define _GNU_SOURCE
    #include <wchar.h>
    wchar_t *wmempcpy(wchar_t *d,
        const wchar_t *s, size_t n);

Description
The `wmemcpy` function copies n wide characters from the object pointed to by s to the object pointed to be 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
`wmempcpy` returns a pointer to the wide character following the last wide character copied to the out region.

Portability
`wmempcpy` is a GNU extension.

No supporting OS subroutines are required.