wcscoll(3C)                                              wcscoll(3C)


       NAME
             wcscoll - wide character string comparison using collating
             information

       SYNOPSIS
             #include <wchar.h>
             int wcscoll(const wchar_t *ws1, const wchar_t *ws2);

       DESCRIPTION
             wcscoll is part of the X/Open Portability Guide Issue 4
             optional Enhanced Internationalization feature group.  It
             compares the wide character string pointed to by ws1 to the
             wide character string pointed to by ws2, which are both
             interpreted as appropriate to the LC_COLLATE category of the
             current locale.

          Return Values
             wcscoll returns 0 and sets errno to ENOSYS.

          Errors
             In the following conditions, wcscoll fails and sets errno to:

            EINVAL The ws1 or ws2 arguments contain wide character codes
                    outside the domain of the collating sequence.

            ENOSYS The function is not supported

       USAGE
             Since no return value is reserved to show an error, if you
             want to check for errors, you should set errno to 0, call
             wcscoll, and then check errno.  If it is non-zero, you can
             assume that an error has occurred.

             Use wcsxfrm and wcscmp for sorting large lists of wide
             character strings.

       REFERENCES
             strcoll(3C), wchar(5), wcscmp(3C), wcsxfrm(3C)










                           Copyright 1994 Novell, Inc.               Page 1