The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 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 zero, ws1 and ws2 must be a valid pointers, and the function copies zero wide-characters.

 RETURN VALUE

The wmemmove function returns the value of ws1.

 ERRORS

No errors are defined

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

<wchar.h>, wmemchr(), wmemcmp(), wmemcpy(), wmemset().

DERIVATION

Derived from the ISO/IEC 9899:1990/Amendment 1:1995 (E).

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]