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)