Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2017
 
 

wmemmove(3C)

Name

wmemmove - copy wide-characters in memory with overlapping areas

Synopsis

#include <wchar.h>

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

Description

The wmemmove() function copies n wide-characters from the object pointed to by ws2 to the object pointed to by ws1. Copying takes place as if the n wide-characters from the object pointed to by ws2 are first copied into a temporary array of n wide-characters that does not overlap the objects pointed to by ws1 or ws2, and then the n wide-characters from the temporary array are copied into the object pointed to by 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 0, ws1 and ws2 must be a valid pointers, and the function copies zero wide-characters.

Return Values

The wmemmove() function returns the value of ws1.

Errors

No errors are defined.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See Also

wmemchr(3C), wmemcmp(3C), wmemcpy(3C), wmemset(3C), attributes(5), standards(5)