NAME
wmemset — set wide
characters in memory
SYNOPSIS
#include
<wchar.h>
wchar_t *wmemset(wchar_t *ws, wchar_t wc, size_t n);
DESCRIPTION
[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2024 defers to the ISO C standard.
The wmemset () function shall copy
the value of wc into
each of the first n wide characters of the object pointed
to by ws. This function shall not be affected by locale
and all wchar_t values shall be treated identically. The
null wide character and wchar_t values not corresponding
to valid characters shall not be treated specially.
If n is zero, the application shall ensure that ws is a valid pointer, and the function shall copy zero wide characters.
[CX] The wmemset ()
function shall not change the setting of errno on valid
input.
RETURN VALUE
The wmemset () functions shall return the
value of ws.
ERRORS
No errors are defined.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
wmemchr(3), wmemcmp(3), wmemcpy(3), wmemmove(3)
XBD <wchar.h>
CHANGE HISTORY
First released in Issue 5. Included for alignment with ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”) (E).
Issue 6
The normative text is updated to avoid use of the term "must" for application requirements.
Issue 8
Austin Group Defect 448 is applied, adding a requirement that
wmemset () does not change the setting of
errno on valid input.