_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

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

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。

語法

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 子字串的關聯。

傳回值	描述
< 0	string1 子字串小於 string2 子字串。
0	string1 子字串等於 string2 子字串。
> 0	string1 子字串大於 string2 子字串。

如果 string1 或 string2 大於 NULLcountINT_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 中的全域狀態。

泛型文字常式對應

Tchar.h 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_tcsncoll	_strncoll	_mbsnbcoll	_wcsncoll
_tcsncoll_l	_strncoll_l	_mbsnbcoll_l	_wcsncoll_l
_tcsnicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll_l	_strnicoll_l	_mbsnbicoll_l	_wcsnicoll_l

需求

常式	必要的標頭
_mbsnbcoll	<mbstring.h>
_mbsnbcoll_l	<mbstring.h>
_mbsnbicoll	<mbstring.h>
_mbsnbicoll_l	<mbstring.h>

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

另請參閱

字串操作
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_mbsnbicmp, _mbsnbicmp_l
strcoll 函數
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l