NAME    [Toc]    [Back]

       strcoll - Compares strings using locale collation

SYNOPSIS    [Toc]    [Back]

       #include <string.h>

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

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       strcoll():  XSH4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies  first  string to be compared.  Specifies second
       string to be compared.

DESCRIPTION    [Toc]    [Back]

       The strcoll() function compares the string pointed  to  by
       the  s1  parameter  with  the  string pointed to by the s2
       parameter, both interpreted as appropriate to the  LC_COLLATE
 category of the current locale.

RETURN VALUES    [Toc]    [Back]

       On  successful  completion, the strcoll() function returns
       an integer whose value is greater than, equal to, or  less
       than  0  (zero),  according  to  whether  the s1 string is
       greater than, equal to, or less than the s2 string.

       [Tru64 UNIX]  When a successful comparison cannot be made,
       this function returns a value of 0 (zero).

ERRORS    [Toc]    [Back]

       The  strcoll() function sets errno to the specified values
       for the following conditions: The string pointed to by the
       s1  or s2 parameter contains characters outside the domain
       of the collating sequence.

SEE ALSO    [Toc]    [Back]

       Functions: setlocale(3), string(3), strcmp(3), strxfrm(3),
       wcscoll(3)

       Standards: standards(5)



                                                       strcoll(3)