strnicmp()

Compare two strings up to a given length, ignoring case

Synopsis:

#include <string.h>

int strnicmp( const char* s1,
              const char* s2,
              size_t len );

Since:

BlackBerry 10.0.0

Arguments:

s1, s2
The strings that you want to compare.
len
The maximum number of characters 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 strnicmp() function compares up to len characters from the strings pointed to by s1 and s2, ignoring case.

Returns:

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

Examples:

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

int main( void )
  {
    printf( "%d\n", strnicmp( "abcdef", "ABCXXX", 10 ) );
    printf( "%d\n", strnicmp( "abcdef", "ABCXXX",  6 ) );
    printf( "%d\n", strnicmp( "abcdef", "ABCXXX",  3 ) );
    printf( "%d\n", strnicmp( "abcdef", "ABCXXX",  0 ) );
    return EXIT_SUCCESS;
  }

produces the output:

-20
-20
0
0

Classification:

QNX 4

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

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus