Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

wmemcpy(3) OSS Library Calls Reference Manual
NAME
wmemcpy - Copy wide characters in memory
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL
G-series native OSS processes: /G/system/sysnn/zcresrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll
SYNOPSIS
#include <wchar.h>
wchar_t *wmemcpy(
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 wmemcpy( ) 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 character.
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 characters are
not treated specially.
The wmemcpy( ) function copies n wide characters from the string pointed to by the ws2 param-
eter into the location pointed to by the ws1 parameter.
NOTES
When copying overlapping strings, the behavior of this function is unreliable.
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 wmemcpy( ) function returns the string pointed to by the ws1 parameter.
RELATED INFORMATION
Functions: wmemchr(3), wmemcmp(3), wmemmove(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.
8−66 Hewlett-Packard Company 527187-017