wcscoll(3C) — DG/UX R4.11MU05



wcscoll(3C)                    DG/UX R4.11MU05                   wcscoll(3C)


NAME
       wcscoll - wide character string comparison using collating
       information

SYNOPSIS
       #include <wchar.h>
       int wcscoll(const wchart *ws1, const wchart *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
       LCCOLLATE 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), wcscmp(3C), wcsxfrm(3C)


Licensed material--property of copyright holder(s)
Museum
