1WMEMCMP(P)                 POSIX Programmer's Manual                WMEMCMP(P)
2
3
4

NAME

6       wmemcmp - compare wide characters in memory
7

SYNOPSIS

9       #include <wchar.h>
10
11       int wmemcmp(const wchar_t *ws1, const wchar_t *ws2, size_t n);
12
13

DESCRIPTION

15       The wmemcmp() function shall compare the first n wide characters of the
16       object pointed to by ws1 to the first n wide characters of  the  object
17       pointed  to  by ws2.  This function shall not be affected by locale and
18       all wchar_t values shall be treated identically. The null wide  charac‐
19       ter  and wchar_t values not corresponding to valid characters shall not
20       be treated specially.
21
22       If n is zero, the application shall ensure that ws1 and ws2  are  valid
23       pointers,  and  the function shall behave as if the two objects compare
24       equal.
25

RETURN VALUE

27       The wmemcmp() function shall return an integer greater than, equal  to,
28       or  less  than  zero,  respectively, as the object pointed to by ws1 is
29       greater than, equal to, or less than the object pointed to by ws2.
30

ERRORS

32       No errors are defined.
33
34       The following sections are informative.
35

EXAMPLES

37       None.
38

APPLICATION USAGE

40       None.
41

RATIONALE

43       None.
44

FUTURE DIRECTIONS

46       None.
47

SEE ALSO

49       wmemchr() , wmemcpy() , wmemmove() , wmemset() , the  Base  Definitions
50       volume of IEEE Std 1003.1-2001, <wchar.h>
51

53       Portions  of  this text are reprinted and reproduced in electronic form
54       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
55       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
56       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
57       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
58       event of any discrepancy between this version and the original IEEE and
59       The  Open Group Standard, the original IEEE and The Open Group Standard
60       is the referee document. The original Standard can be  obtained  online
61       at http://www.opengroup.org/unix/online.html .
62
63
64
65IEEE/The Open Group                  2003                           WMEMCMP(P)
Impressum