[Previous] [Contents] [Index] [Next]

wmemcpy()

Copy wide characters from one buffer to another

Synopsis:

#include <wchar.h>

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

Library:

libc

Description:

The wmemcpy() function copies n bytes from the buffer pointed to by ws2 into the buffer pointed to by ws1.

The wmemcpy() function is locale-independent and treats all wchar_t values identically, even if they're null or invalid characters.


Note: Copying overlapping buffers isn't guaranteed to work; use wmemmove() to copy buffers that overlap.

Returns:

A pointer to the destination buffer ws1.

Classification:

ANSI

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

"Memory manipulation functions" and "Wide-character functions" in the summary of functions chapter.


[Previous] [Contents] [Index] [Next]