strcoll(3C)                    DG/UX 5.4R3.00                    strcoll(3C)


NAME
       strcoll - string collation

SYNOPSIS
       #include <string.h>

       int strcoll (const char *s1, const char *s2);

DESCRIPTION
       strcoll returns an integer greater than, equal to, or less than zero
       in direct correlation to whether string s1 is greater than, equal to,
       or less than the string s2.  The comparison is based on strings
       interpreted as appropriate to the program's locale for category
       LCCOLLATE [see setlocale(3C)].

       Both strcoll and strxfrm provide for locale-specific string sorting.
       strcoll is intended for applications in which the number of
       comparisons per string is small.  When strings are to be compared a
       number of times, strxfrm is a more appropriate utility because the
       transformation process occurs only once.


   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |              point    safe  |
                     +---------+-----------------------------+
                     |strcoll  |     Y          N        N   |
                     +---------+-----------------------------+
       strcoll should be called when the other threads in a process are not
       changing the LCCOLLATE database.  See the setlocale(3C) man page for
       more information.


FILES
        /usr/lib/locale/LCCOLLATE
                              LCCOLLATE database for locale.

SEE ALSO
       reentrant(3), setlocale(3C), string(3C), strxfrm(3C), environ(5).
       colltbl(1M).















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