_mbsnbcoll、 、 _mbsnbcoll_l、 _mbsnbicoll_mbsnbicoll_l

使用多位元組字碼頁資訊，比較兩個多位元組字元字串的 n 個位元組。

語法

int _mbsnbcoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _mbsnbcoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);
int _mbsnbicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _mbsnbicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

參數

string1, string2
要比較的字串。

count
要比較的位元組數目。

locale
要使用的地區設定。

傳回值

傳回值，表示 string1 子字串和 string2 子字串的關聯。

如果 string1 或 string2 大於 NULL count INT_MAX，則會叫用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行，這些函式會傳回 _NLSCMPERROR，並將 errno 設為 EINVAL。 若要使用 _NLSCMPERROR，請包括 String.h 或 Mbstring.h。

備註

所有這些函式最多會對照 string1 和 string2 中的前 count 個位元組，並傳回指出所產生的 string1 子字串和 string2 子字串之間關聯性的值。 如果 或 string2 子字串string1中的最後一個字節是前置位元組，則不會包含在比較中;這些函式只會比較子字串中的完整字元。 _mbsnbicoll 是不區分大小寫版本的 _mbsnbcoll。 如同 _mbsnbcmp 和 _mbsnbicmp，_mbsnbcoll 和 _mbsnbicoll 會根據目前使用的多位元組字碼頁所指定的詞典編纂順序，來對照兩個多位元組字元字串。

針對某些字碼頁和對應的字元集，字元集中的字元順序可能與詞典編纂的字元順序不同。 在 「C」 地區設定中，ASCII 字元集中字元的順序與字元的語彙順序相同。 不過，某些歐洲字碼頁中的字元順序卻不同，例如，字元 'a' (值 0x61) 在字元集中排在字元 'ä' (值 0xE4) 之前，但在詞典編纂上，字元 'a' 卻排在字元 'ä' 之後。 若要在此情況下逐字元組執行字串的詞典編纂比較，請使用 _mbsnbcoll 而不是 _mbsnbcmp；若只要檢查字串是否相等，請使用 _mbsnbcmp。

因為 coll 函式會以詞典編纂方式對照字串以進行比較，而 cmp 函式只會測試字串是否相等，所以 coll 函式比對應的 cmp 版本慢很多。 因此， coll 只有在目前代碼頁中的字元集順序與語彙字元順序之間有差異，而且這項差異對於比較而言，才應該使用函式。

輸出值會受到設定地區設定之 LC_CTYPE 類別設定的影響。 如需詳細資訊，請參閱setlocale。 這些沒有 _l 後置字元的函式版本，會針對此與地區設定相關的行為使用目前的地區設定；具有 _l 後置字元的版本也一樣，只不過它們會改用傳遞的地區設定參數。 如需詳細資訊，請參閱 Locale。

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

一般文字常式對應

需求

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

另請參閱

字串操作
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_mbsnbicmp, _mbsnbicmp_l
strcoll 函數
strncmp、 、 wcsncmp、 _mbsncmp_mbsncmp_l
_strnicmp、、_wcsnicmp_mbsnicmp、_strnicmp_l、、_wcsnicmp_l、_mbsnicmp_l