wmemory(3C)wmemory(3C)NAMEwmemchr(), wmemcmp(), wmemcpy(), wmemmove(), wmemset() - memory opera‐
tions based on wide-character
SYNOPSISDESCRIPTION
These functions operate as efficiently as possible on memory areas
(arrays of wide-characters bounded by a count, not terminated by a null
wide-character). They do not check for the overflow of any receiving
memory area.
These functions are not affected by locale and all values are treated
identically. The null wide-character and values not corresponding to
valid characters are not treated specially.
The function locates the first occurrence of wc in the ini‐
tial n wide-characters of the object pointed to by ws.
The function returns a pointer to the located wide-char‐
acter or a null pointer if the wide-character does not
occur in the object.
The function compares the first n wide-characters of the
object pointed to by ws1 to the first n wide-characters
of the object pointed to by ws2. The function returns
an integer greater than, equal to, or less than zero,
accordingly as the object pointed to by ws1 is greater
than, equal to, or less than the object pointed to by
ws2.
The function copies n wide-characters from the object
pointed to by ws2 to the object pointed to by ws1. The
null wide-character and values not corresponding to
valid characters are not treated specially. The func‐
tion returns the value of ws1.
The 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 tempo‐
rary 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. The function returns the
value of ws1.
The function copies the value of wc into each of the first n
wide-characters of the object pointed to by ws. The
function returns the value of ws.
APPLICATION USAGE
The prototypes of these functions are available to applications if they
are:
a. conformant.
b. Compiled with macro with a value >= 500.
c. Compiled with macro with a value >= 200112.
ERRORS
No errors are defined.
AUTHOR
were developed by HP and Mitsubishi Electric Corp.
SEE ALSOthread_safety(5), glossary(9).
wmemory(3C)