_strnicoll、 _wcsnicoll、 _mbsnicoll、 _strnicoll_l、 _wcsnicoll_l、 _mbsnicoll_l

發行項
03/26/2013

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

重要

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

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

參數

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

傳回值

這些函式都會傳回值 string1 和 string2的子關聯性的值*，* 如下所示。

傳回值	string1 string2 關聯性
< 0	string1 小於 string2
0	string1 與 string2 相同
> 0	string1 大於 string2

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

備註

這些函式都會在 string1 和 string2 執行的第一個 count 字元的不區分大小寫的比較根據字碼頁。應該使用這些函式，才會在字元集順序時和字典會在字碼頁和這個差異之間的一個差異是字串比較的利益。這些函式版本沒有 _l 尾碼來使用目前的地區設定和字碼頁。與_l 結尾的版本相同，但使用的地區設定。如需詳細資訊，請參閱地區設定。

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

泛用文字常式對應