HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

661

662

663

664

665

666

667

668

669

670

wmemory(3C) wmemory(3C)

NAME

wmemchr(), wmemcmp(), wmemcpy(), wmemmove(), wmemset() - memory operations based on wide-

character

SYNOPSIS

#include <wchar.h>

wchar_t *wmemchr(const wchar_t *ws, wchar_t wc, size_t n);

int wmemcmp(const wchar_t *ws1, const wchar_t *ws2, size_t n);

wchar_t *wmemcpy(wchar_t *__restrict ws1, const wchar_t *__restrict ws2,

size_t n);

wchar_t *wmemmove(wchar_t *ws1, const wchar_t *ws2, size_t n);

wchar_t *wmemset(wchar_t *ws, wchar_t wc, size_t n);

DESCRIPTION

These functions operate as efﬁciently 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 overﬂow of any receiving

memory area.

These functions are not affected by locale and all wchar_t values are treated identically. The null wide-

character and wchar_t values not corresponding to valid characters are not treated specially.

wmemchr() The wmemchr() function locates the ﬁrst occurrence of wc in the initial n wide-characters

of the object pointed to by ws. The

wmemchr() function returns a pointer to the located

wide-character or a null pointer if the wide-character does not occur in the object.

wmemcmp() The wmemcmp() function compares the ﬁrst n wide-characters of the object pointed to by

ws1 to the ﬁrst n wide-characters of the object pointed to by ws2. The

wmemcmp() func-

tion 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.

wmemcpy() The wmemcpy() function copies n wide-characters from the object pointed to by ws2 to

the object pointed to by ws1. The null wide-character and

wchar_t values not

corresponding to valid characters are not treated specially. The

wmemcpy() function

returns the value of ws1.

wmemmove() The wmemmove() 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 ﬁrst 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

wmemmove() func-

tion returns the value of ws1.

wmemset() The wmemset() function copies the value of wc into each of the ﬁrst n wide-characters of

the object pointed to by ws. The

wmemset() function returns the value of ws.

APPLICATION USAGE

The prototypes of these functions are available to applications if they are:

c99 conformant.

b. Compiled with -D_XOPEN_SOURCE macro with a value >= 500.

c. Compiled with -D_POSIX_C_SOURCE macro with a value >= 200112.

ERRORS

No errors are deﬁned.

AUTHOR

wmemchr(), wmemcmp(), wmemcpy(), wmemmove() , wmemset() were developed by HP and

Mitsubishi Electric Corp.