*** UNIX MANUAL PAGE BROWSER ***

strcoll(3) Library Functions Manual strcoll(3) NAME strcoll - Compares strings using locale collation LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <string.h> int strcoll( const char *s1, const char *s2); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: strcoll(): XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. PARAMETERS Specifies first string to be compared. Specifies second string to be compared. DESCRIPTION The strcoll() function compares the string pointed to by the s1 parame- ter with the string pointed to by the s2 parameter, both interpreted as appropriate to the LC_COLLATE category of the current locale. RETURN VALUES 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. [Digital] When a successful comparison cannot be made, this function returns a value of 0 (zero). ERRORS The strcoll() function sets errno to the specified values for the fol- lowing conditions: The string pointed to by the s1 or s2 parameter con- tains characters outside the domain of the collating sequence. RELATED INFORMATION Functions: setlocale(3), string(3)/strcmp(3), strxfrm(3), wcscoll(3) Standards: standards(5) delim off strcoll(3)