_mbsnbicmp _mbsnbicmp_l

發行項
03/27/2013

比較 n 的兩個位元組多位元組字元字串，忽略大小寫。

重要事項
這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

int _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

參數

string1, string2
要比較的 NULL 結尾字串。
count
要比較的位元組數目。

傳回值

傳回值表示子字串之間的關聯性。

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

在錯誤， _mbsnbcmp 會傳回 _NLSCMPERROR，在 String.h 和 Mbstring.h 定義。

備註

字典 _mbsnbicmp函式比較，最多，第一個 count 位元組 string1 和 string2。執行比較不考慮大小寫; _mbsnbcmp是 _mbsnbicmp的區分大小寫的版本。比較結束，則會結束的 null 字元在任何資料之前，在 count 字元進行比較之前。如果字串是等，以便結束的 null 字元在任一字串時為止， count 字元進行比較之前，較短的字串是較少。

_mbsnbicmp與 _mbsnicmp類似，不同的是，它由位元組比較字串而不是字元。

包含字元的兩個字串位於「Z」和「a」之間在不同 ASCII 表 (「[」，「\」，「]」，「、」，「_」，以及「) 比較，根據的條件。例如，兩個字串「ABCDE」和「ABCD^」比較的一種方法，當比較小寫 ("abcde」> 「abcd^") 和另一個方式 ("ABCDE」< 「ABCD^")，則大寫。

_mbsnbicmp表示根據目前使用的多位元組字碼頁辨識多位元組字元序列。它不會影響目前地區設定的。

如果 string1 或 string2 為 null 指標， _mbsnbicmp 叫用無效的參數處理常式如參數驗證中所述。如果執行允許繼續執行，函式會傳回 _NLSCMPERROR和 errno 設為 EINVAL。

泛用文字常式對應