Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

wmemmove(3) Guardian Native C Library Calls Reference Manual
NAME
wmemmove - Copy wide characters with overlapping areas in memory
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL
G-series native OSS processes: /G/system/sysnn/zcresrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
H-series OSS processes: /G/system/zdllnnn/zcredll
SYNOPSIS
#include <wchar.h>
wchar_t *wmemmove(
wchar_t *ws1,
const wchar_t *ws2,
size_t n);
PARAMETERS
ws1 Points to the location of a destination string.
ws2 Points to the location of a source string.
n Specifies the number of wide characters to copy.
DESCRIPTION
The wmemmove() function operates on wide-character strings in memory areas. A memory
area is a group of contiguous wide characters bound by a count and not terminated by a null char-
acter. The behavior of this function is not affected by locale and all wchar_t characters are
treated identically; the null wide character and wchar_t values not corresponding to valid char-
acters are not treated specially.
The wmemmove() function copies n wide characters from the string at the location pointed to by
the ws2 parameter to the string at the location pointed to by the ws1 parameter. Copying takes
place as though the n number of wide characters from string ws2 are first copied into a temporary
location having n wide characters that do not overlap either of the strings pointed to by ws1 and
ws2. Then, n number of wide characters from the temporary location are copied to the string
pointed to by ws1. Consequently, this operation is nondestructive and proceeds from left to right.
NOTES
If n is 0 (zero), ws1 and ws2 must be valid pointers; in this instance, the function behaves as if it
copied 0 (zero) characters.
RETURN VALUES
The wmemmove() function returns the string pointed to by the ws1 parameter.
RELATED INFORMATION
Functions: wmemchr(3), wmemcmp(3), wmemcpy(3), wmemset(3).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification and conforms with the Single
UNIX Specification, Version 2.
7−98 Hewlett-Packard Company 527192-005