strcoll(3C)         (C Programming Language Utilities)          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.

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

   SEE ALSO
         setlocale(3C), string(3C), strxfrm(3C), environ(5).
         colltbl(1M) in the System Administrator's Reference Manual.

























   8/91                                                                 Page 1