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

NAME

6       wcscmp - compare two wide-character strings
7

SYNOPSIS

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

DESCRIPTION

15       The  wcscmp()  function shall compare the wide-character string pointed
16       to by ws1 to the wide-character string pointed to by ws2.
17
18       The sign of a non-zero return value shall be determined by the sign  of
19       the  difference  between the values of the first pair of wide-character
20       codes that differ in the objects being compared.
21

RETURN VALUE

23       Upon completion, wcscmp() shall return an integer greater  than,  equal
24       to,  or  less than 0, if the wide-character string pointed to by ws1 is
25       greater than, equal to, or less than the wide-character string  pointed
26       to by ws2, respectively.
27

ERRORS

29       No errors are defined.
30
31       The following sections are informative.
32

EXAMPLES

34       None.
35

APPLICATION USAGE

37       None.
38

RATIONALE

40       None.
41

FUTURE DIRECTIONS

43       None.
44

SEE ALSO

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