Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

stricmp()

Compare two strings, ignoring case

Synopsis:

#include <string.h>

int stricmp( 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 stricmp() function compares, with case insensitivity, the string pointed to by s1 to the string pointed to by s2. All uppercase characters from s1 and s2 are mapped to lowercase for the purposes of doing the comparison.

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>

int main( void )
  {
    printf( "%d\n", stricmp( "AbCDEF", "abcdef" ) );
    printf( "%d\n", stricmp( "abcdef", "ABC"    ) );
    printf( "%d\n", stricmp( "abc",    "ABCdef" ) );
    printf( "%d\n", stricmp( "Abcdef", "mnopqr" ) );
    printf( "%d\n", stricmp( "Mnopqr", "abcdef" ) );

    return EXIT_SUCCESS;
  }

produces the output:

0
100
-100
-12
12

Classification:

QNX 4

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

See also:

strcasecmp(), strcmp(), strcmpi(), strcoll(), strncasecmp(), strncmp(), strnicmp(), wcscmp(), wcscoll(), wcsncmp()