Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (t - z) wmemset(3)
NAME
wmemset - Sets 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 *wmemset(
wchar_t *ws,
wchar_t wc,
size_t n);
PARAMETERS
ws Points to the location of a string.
wc Specifies the first wide character to copy.
n Specifies the number of wide characters to copy.
DESCRIPTION
The wmemset() 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 wmemset() function copies the value of the wide character specified by the wc parameter,
which is a wchar_t, into each of the first n locations of the string pointed to by the ws parameter.
NOTES
If n is 0 (zero), ws must be a valid pointer; in this instance, the function behaves as if it copies 0
(zero) characters.
RETURN VALUES
The wmemset() function returns the string pointed to by the ws parameter.
RELATED INFORMATION
Functions: wmemchr(3), wmemcmp(3), wmemcpy(3), wmemmove(3).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification and conforms with the Single
UNIX Specification, Version 2.
527192-018 Hewlett-Packard Company 7−197