wmemory(3C) wmemory(3C)
NAME
wmemchr(), wmemcmp(), wmemcpy(), wmemmove(), wmemset() - memory operations based on wide-character
SYNOPSIS
DESCRIPTION
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 initial n wide-characters of the object pointed to by ws. The function
returns a pointer to the located wide-character 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-charac-
ter and values not corresponding to valid characters are not treated specially. The function 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 temporary 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 ALSO
thread_safety(5), glossary(9).
wmemory(3C)