_strncoll、_wcsncoll、_mbsncoll、_strncoll_l、_wcsncoll_l、_mbsncoll_l

發行項
06/09/2015

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

重要

_mbsncoll 與_mbsncoll_l不能用於Windows 執行階段中執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

int _strncoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_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 包含在定序序列的網域之外之寬字元程式碼，_wcsncoll 可能會失敗。發生錯誤時， _wcsncoll 會將 errno 設定為 EINVAL。若要檢查呼叫 _wcsncoll 上的錯誤，請將 errno 設定為 0 然後再呼叫 _wcsncoll 之後檢查 errno 。

備註

這些函式都會根據目前使用的字碼頁在 string1 和 string2 執行的第一個 count 字元的區分大小寫的比較。這些函式應該只有在字碼頁上，字元集順序和字典字元順序存在差異，且當這些差異影響到字串比較時，才會使用。字元集順序是與地區設定相關的。沒有 _l 結尾的函式版本使用目前的地區設定，不過，具有 _l 結尾的函式版本使用傳遞進來的地區設定。如需詳細資訊，請參閱地區設定。

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

一般文字常式對應