![]() |
![]() |
![]() |
![]() |
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 );
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:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | Yes |
| Signal handler | Yes |
| Thread | Yes |
See also:
strcasecmp(), strcmp(), strcmpi(), strcoll(), stricmp(), strncasecmp(), strncmp(), wcscmp(), wcscoll(), wcsncmp()
![]() |
![]() |
![]() |
![]() |

![[Previous]](../prev.gif)
![[Contents]](../contents.gif)
![[Index]](../keyword_index.gif)
![[Next]](../next.gif)