wmemcpy()

Updated: April 19, 2023

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 );

Arguments:

ws1
A pointer to the buffer that you want to copy the wide characters into.
ws2
A pointer to the buffer that you want to copy the wide characters from.
n
The number of wide characters to copy.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wmemcpy() function copies n wide characters 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 (i.e., the same pointer as ws1).

Classification:

ANSI, POSIX 1003.1

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