Standard C Library Functions                          strcoll(3C)

NAME
     strcoll - string collation

SYNOPSIS
     #include <string.h>

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

DESCRIPTION
     Both strcoll() and strxfrm(3C) 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(3C) is
     a more appropriate function because the transformation  pro-
     cess occurs only once.

RETURN VALUES
     Upon successful completion,  strcoll()  returns  an  integer
     greater than, equal to, or less than zero in direct correla-
     tion 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 LC_COLLATE (see setlocale(3C)).

     On error, strcoll() may set errno, but no  return  value  is
     reserved to indicate an error.

ERRORS
     The strcoll() function may fail if:

     EINVAL
           The s1 or s2 arguments contain characters outside  the
           domain of the collating sequence.

FILES
     /usr/lib/locale/locale/locale.so.*
           LC_COLLATE database for locale

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|

SunOS 5.8           Last change: 20 Dec 1996                    1

Standard C Library Functions                          strcoll(3C)

SEE ALSO
     localedef(1),   setlocale(3C),   string(3C),    strxfrm(3C),
     wsxfrm(3C), attributes(5), environ(5)

NOTES
     The strcoll() function can be used safely  in  multithreaded
     applications,  as  long as setlocale(3C) is not being called
     to change the locale.

SunOS 5.8           Last change: 20 Dec 1996                    2