strcoll()

Compare two strings using the locale's collating sequence

Synopsis:

#include <string.h>

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

Library:

libc

Description:

The strcoll() function compares the string pointed to by s1 to the string pointed to by s2. The comparison uses the collating sequence selected by the setlocale() function. The function is equivalent to the strcmp() function when the collating sequence is selected from the "C" locale.

Returns:

< 0: s1 is less than s2.
0: s1 is equal to s2.
> 0: s1 is greater than s2.

Examples:

#include <stdio.h>
#include <string.h>
#include <stdlib.h>

char buffer[80] = "world";

int main( void )
{
    if( strcoll( buffer, "Hello" ) < 0 ) {
        printf( "Less than\n" );
    }

    return EXIT_SUCCESS;
}

Classification:

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes

See also:

setlocale(), strcmp(), strncmp()