_stricmp、、_wcsicmp_mbsicmp、_stricmp_l、、_wcsicmp_l、_mbsicmp_l

執行字串的不區分大小寫比較。

語法

int _stricmp(
   const char *string1,
   const char *string2
);
int _wcsicmp(
   const wchar_t *string1,
   const wchar_t *string2
);
int _mbsicmp(
   const unsigned char *string1,
   const unsigned char *string2
);
int _stricmp_l(
   const char *string1,
   const char *string2,
   _locale_t locale
);
int _wcsicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale
);
int _mbsicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

參數

string1, string2
以 Null 結束的待比較字串。

locale
要使用的地區設定。

傳回值

傳回值，表示 string1 對 string2 的關聯，如下所示。

在錯誤中，_mbsicmp傳_NLSCMPERROR回 ，其定義於和<mbstring.h>中<string.h>。

備註

函_stricmp式會string1string2比較每個字元，並在將每個字元轉換成小寫之後，並傳回指出其關聯性的值。 _stricmp 與 _stricoll 不同之處為，_stricmp 比較只會受到 LC_CTYPE 的影響，它會決定哪些字元為大寫和小寫。 _stricoll 函式會根據地區設定的 LC_CTYPE 和 LC_COLLATE 分類，其中包括大小寫和定序排序，來比較字串。 如需類別的詳細資訊 LC_COLLATE ，請參閱 setlocale 和 地區設定類別。 沒有 _l 字尾的這些函式版本，會針對與地區設定相依的行為，使用目前的地區設定。 具有字尾的版本也一樣，只不過它們改用傳入的地區設定。 如果未設定地區設定，則會使用 C 地區設定。 如需詳細資訊，請參閱 Locale。

_strcmpi 函式相當於 _stricmp，而且只是為了回溯相容性而提供。

因為 _stricmp 有小寫的比較，這可能會導致非預期的行為。

為了說明案例轉換何時 _stricmp 會影響比較的結果，假設您有兩個字串 JOHNSTON 和 JOHN_HENRY。 字串 JOHN_HENRY 會被視為小於 JOHNSTON ，因為 “_” 的 ASCII 值低於小寫 S。事實上，任何在 91 到 96 之間具有 ASCII 值的字元都會被視為小於任何字母。

如果使用函 strcmp 式而非 _stricmp， JOHN_HENRY 將會大於 JOHNSTON。

_wcsicmp 和 _mbsicmp 分別是 _stricmp 的寬字元版本和多位元組字元版本。 的自變數和傳回值 _wcsicmp 是寬字元字串。 的自變數和傳回值 _mbsicmp 是多位元組位元元字串。 _mbsicmp 根據目前的多位元組字碼頁來辨識多位元組字元序列，並在發生錯誤時傳回 _NLSCMPERROR。 如需詳細資訊，請參閱 代碼頁。 除此之外，這三個函式的行為相同。

_wcsicmp 和 wcscmp 的行為相同， wcscmp 不同之處在於，在比較自變數之前，不會將其自變數轉換成小寫。 _mbsicmp 和 _mbscmp 的行為相同， _mbscmp 不同之處在於，在比較自變數之前，不會將其自變數轉換成小寫。

您必須呼叫 setlocale _wcsicmp 才能使用拉丁文 1 個字元。 C 地區設定預設會生效，因此，例如，ä 不會比較等於 Ä。 搭配 C 地區設定以外的任何地區設定呼叫 setlocale 會在 _wcsicmp 呼叫之前。 下列範例示範地區設定如何影響 _wcsicmp：

// crt_stricmp_locale.c
By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).

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

int main() {
   setlocale(LC_ALL,"C");   // in effect by default
   printf("\n%d",_wcsicmp(L"ä", L"Ä"));   // compare fails
   setlocale(LC_ALL,"");
   printf("\n%d",_wcsicmp(L"ä", L"Ä"));   // compare succeeds
}

替代方法是呼叫 _create_locale， _wcreate_locale 並將傳回的地區設定物件當做參數傳遞至 _wcsicmp_l。

這些函式全都會驗證它們的參數。 string1如果 或 string2 為 Null 指標，則會叫用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行，這些函式會傳回 _NLSCMPERROR，並將 errno 設為 EINVAL。

一般文字常式對應

需求

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

範例

// crt_stricmp.c

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

char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown dog jumps over the lazy fox";

int main( void )
{
   char tmp[20];
   int result;

   // Case sensitive
   printf( "Compare strings:\n   %s\n   %s\n\n", string1, string2 );
   result = strcmp( string1, string2 );
   if( result > 0 )
      strcpy_s( tmp, _countof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, _countof(tmp), "less than" );
   else
      strcpy_s( tmp, _countof(tmp), "equal to" );
   printf( "   strcmp:   String 1 is %s string 2\n", tmp );

   // Case insensitive (could use equivalent _stricmp)
   result = _stricmp( string1, string2 );
   if( result > 0 )
      strcpy_s( tmp, _countof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, _countof(tmp), "less than" );
   else
      strcpy_s( tmp, _countof(tmp), "equal to" );
   printf( "   _stricmp:  String 1 is %s string 2\n", tmp );
}

Compare strings:
   The quick brown dog jumps over the lazy fox
   The QUICK brown dog jumps over the lazy fox

   strcmp:   String 1 is greater than string 2
   _stricmp:  String 1 is equal to string 2

另請參閱

字串操作
memcmp, wmemcmp
_memicmp, _memicmp_l
strcmp、 、 wcscmp_mbscmp
strcoll 函數
strncmp、 、 wcsncmp、 _mbsncmp_mbsncmp_l
_strnicmp、、_wcsnicmp_mbsnicmp、_strnicmp_l、、_wcsnicmp_l、_mbsnicmp_l
strrchr、 、 wcsrchr、 _mbsrchr_mbsrchr_l
_strset、、_strset_l_wcsset、_wcsset_l、、_mbsset、_mbsset_l
strspn、 、 wcsspn、 _mbsspn_mbsspn_l