WMEMCPY(3C) Standard C Library Functions WMEMCPY(3C)

NAME

wmemcpy - copy wide-characters in memory

SYNOPSIS

#include <wchar.h>

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

DESCRIPTION

The wmemcpy() function copies n wide-characters from the object pointed
to by ws2 to the object pointed to be ws1. 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, ws1 and ws2 must be a valid pointers, and the function
copies zero wide-characters.

RETURN VALUES

The wmemcpy() function returns the value of ws1.

ERRORS

No errors are defined.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

wmemchr(3C), wmemcmp(3C), wmemmove(3C), wmemset(3C), attributes(7),
standards(7)


August 14, 2002 WMEMCPY(3C)