_stricoll、 _wcsicoll、 _mbsicoll、 _stricoll_l、 _wcsicoll_l、 _mbsicoll_l

發行項
03/26/2013

使用地區設定特定的資訊來比較字串。

重要

_mbsicoll 和 _mbsicoll_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

int _stricoll(
   const char *string1,
   const char *string2 
);
int _wcsicoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbsicoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _stricoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale
);
int _wcsicoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale
);
int _mbsicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

參數

string1, string2
要比較的 NULL 結尾字串。
locale
使用的地區設定。

傳回值

這些函式都會傳回表示 string1 的關聯性值設定為 string2*，* 如下所示。

傳回值	string1 string2 關聯性
< 0	string1 小於 string2
0	string1 與 string2 相同
> 0	string1 大於 string2
_NLSCMPERROR	發生錯誤。

這些函式會傳回 _NLSCMPERROR中的每個。若要使用 _NLSCMPERROR，包含 STRING.H 或 MBSTRING.H。如果 string1 或 string2 包含在定序序列的網域之外，寬字元程式碼_wcsicoll 可能會失敗。發生錯誤時， _wcsicoll 會將 errno 設定為 EINVAL。若要檢查名為的錯誤到 _wcsicoll，請將 errno 設定為 0 在呼叫 _wcsicoll之後檢查 errno 。

備註

這些函式都會根據目前使用的字碼頁執行 string1 和 string2 不區分大小寫的比較。應該使用這些函式，才會在字元集順序時和字典會在目前字碼頁和這個差異之間的一個差異是字串比較的利益。

_stricmp 與 _stricoll 不同之處在於 _stricmp 比較不受 LC_CTYPE的影響，，而 _stricoll 比較是根據地區設定的 LC_CTYPE 和 LC_COLLATE 類別。如需 LC_COLLATE 分類的詳細資訊，請參閱 setlocale 和地區設定分類。這些函式版本沒有 _l 尾碼來使用目前的地區設定;與 _l 結尾的版本相同，但使用的地區設定。如需詳細資訊，請參閱地區設定。

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

泛用文字常式對應