strcoll()

Compare two strings, using the locale's collating sequence

Synopsis:

#include <string.h>

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

Arguments:

s1, s2: The strings that you want to compare.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The strcoll() function compares the strings pointed to by s1 and s2, using the collating sequence selected by the setlocale() function.

The strcoll() function is equivalent to strcmp() 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:

ANSI, POSIX 1003.1

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