Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Compares characters in two buffers (case-insensitive).
int_memicmp(constvoid*buf1,constvoid*buf2,unsignedintcount**);**
Routine | Required Header | Compatibility |
_memicmp | <memory.h> or <string.h> | Win 95, Win NT |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
LIBC.LIB | Single thread static library, retail version |
LIBCMT.LIB | Multithread static library, retail version |
MSVCRT.LIB | Import library for MSVCRT.DLL, retail version |
Return Value
The return value indicates the relationship between the buffers.
Return Value | Relationship of First count Bytes of buf1 and buf2 |
< 0 | buf1 less than buf2 |
0 | buf1 identical to buf2 |
> 0 | buf1 greater than buf2 |
Parameters
buf1
First buffer
buf2
Second buffer
count
Number of characters
Remarks
The _memicmp function compares the first count characters of the two buffers buf1 and buf2 byte by byte. The comparison is not case sensitive.
Example
/* MEMICMP.C: This program uses _memicmp to compare
* the first 29 letters of the strings named first and
* second without regard to the case of the letters.
*/
#include <memory.h>
#include <stdio.h>
#include <string.h>
void main( void )
{
int result;
char first[] = "Those Who Will Not Learn from History";
char second[] = "THOSE WHO WILL NOT LEARN FROM their mistakes";
/* Note that the 29th character is right here ^ */
printf( "Compare '%.29s' to '%.29s'\n", first, second );
result = _memicmp( first, second, 29 );
if( result < 0 )
printf( "First is less than second.\n" );
else if( result == 0 )
printf( "First is equal to second.\n" );}
else if( result > 0 )
printf( "First is greater than second.\n" );
}
Output
Compare 'Those Who Will Not Learn from' to 'THOSE WHO WILL NOT LEARN FROM'
First is equal to second.
See Also _memccpy, memchr, memcmp, memcpy, memset, _stricmp, _strnicmp