共用方式為


_memicmp, _memicmp_l

比較兩個緩衝區中的字元 (不區分大小寫)。

語法

int _memicmp(
   const void *buffer1,
   const void *buffer2,
   size_t count
);
int _memicmp_l(
   const void *buffer1,
   const void *buffer2,
   size_t count,
   _locale_t locale
);

參數

buffer1
第一個緩衝區。

buffer2
第二個緩衝區。

count
字元數。

locale
要使用的地區設定。

傳回值

傳回值表示緩衝區之間的關聯性。

傳回值 buf1 和 buf2 的前幾個位元組的關聯性
< 0 buffer1 小於 buffer2
0 buffer1 等於 buffer2
> 0 buffer1 大於 buffer2
_NLSCMPERROR 發生錯誤。

備註

_memicmp 函式會逐位元組比較兩個緩衝區 buffer1buffer2 的前 count 個位元組。 比較不區分大小寫。

buffer1如果 或 buffer2 為 Null 指標,此函式會叫用無效的參數處理程式,如參數驗證中所述。 如果允許繼續執行,函式會傳回 _NLSCMPERROR,並將 errno 設為 EINVAL

_memicmp 會針對與地區設定相關的行為使用目前的地區設定;_memicmp_l 與其相同,只不過它會改用傳入的地區設定。 如需詳細資訊,請參閱 Locale

根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態

需求

常式 必要的標頭
_memicmp <memory.h> 或 <string.h>
_memicmp_l <memory.h> 或 <string.h>

如需相容性詳細資訊,請參閱相容性

範例

// crt_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>

int 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" );
}
Compare 'Those Who Will Not Learn from' to 'THOSE WHO WILL NOT LEARN FROM'
First is equal to second.

另請參閱

緩衝區操作
_memccpy
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset
_stricmp、、_wcsicmp_mbsicmp_stricmp_l、、_wcsicmp_l_mbsicmp_l
_strnicmp、、_wcsnicmp_mbsnicmp_strnicmp_l、、_wcsnicmp_l_mbsnicmp_l