NAME

wmemcpy - copy an array of wide-characters

LIBRARY

Standard C library (libc, -lc)

SYNOPSIS

#include <wchar.h>

wchar_t *wmemcpy(wchar_t dest[restrict .n],
                 const wchar_t src[restrict .n],
                 size_t n);

DESCRIPTION

The wmemcpy() function is the wide-character equivalent of the memcpy(3) function. It copies n wide characters from the array starting at src to the array starting at dest.

The arrays may not overlap; use wmemmove(3) to copy between overlapping arrays.

The programmer must ensure that there is room for at least n wide characters at dest.

RETURN VALUE

wmemcpy() returns dest.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

STANDARDS

C11, POSIX.1-2008.

HISTORY

POSIX.1-2001, C99.

SEE ALSO

memcpy(3), wcscpy(3), wmemmove(3), wmempcpy(3)