Manual Pages for UNIX Operating System command usage for man strcoll

Standard C Library Functions                          strcoll(3C)



NAME
     strcoll - string collation

SYNOPSIS
     #include 

     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.


     The strcoll() function does not change the setting of  errno
     if successful.


     Since no return value is reserved to indicate an  error,  an
     application wishing to check for error situations should set
     errno to 0, then call strcoll(), then check errno.

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






SunOS 5.11           Last change: 1 Nov 2003                    1






Standard C Library Functions                          strcoll(3C)



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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|



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

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




























SunOS 5.11           Last change: 1 Nov 2003                    2