_mbsbtype _mbsbtype_l
回傳字串裏的位元組型別。
.gif "重要事項") 重要事項 |
|---|
這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。 |
int _mbsbtype(
const unsigned char *mbstr,
size_t count
);
int _mbsbtype_l(
const unsigned char *mbstr,
size_t count,
_locale_t locale
);
參數
mbstr
多位元組字元序列的位址。count
從字串開頭的位移 (以位元組為單位)。locale
使用的地區設定。
傳回值
_mbsbtype 和 _mbsbtype_l傳回表示測試結果在指定的位元組的整數值。下表的表示常值定義於 Mbctype.h 。
傳回值 |
Byte 型別 |
|---|---|
_MBC_SINGLE (0) |
單一位元組字元。例如，在字碼頁 932 ， _mbsbtype 會在指定的位元組位於 0x20 - 0x7E 或 0xA1 - 0xDF 的範圍時回傳零。 |
_MBC_LEAD (1) |
多位元組字元的前導位元組。例如，在字碼頁 932， _mbsbtype 會在指定的位元組位於 0x81 - 0x9F 或 0xE0 - 0xFC 的範圍時回傳零。 |
_MBC_TRAIL (2) |
多位元組字元的結尾位元組。例如，在字碼頁 932 ， _mbsbtype 會在指定的位元組位於 0x40 - 0x7E 或 0x80 - 0xFC 的範圍時回傳 2 。 |
_MBC_ILLEGAL (–1) |
NULL 字串，無效字元，或在 mbstr 裏，位元組 NULL 在位移 count 位元組前先被遇見。 |
備註
_mbsbtype 函式判斷在一個多位元組字元字串的位元組型別。此函式只會在 count 裏檢查位移 mbstr 位元組並在指定的位元組之前忽略無效的字元。
輸出值受地區設定的LC_CTYPE 分類設定所影響。如需詳細資訊，請參閱 setlocale 。這些函式沒有以 _l 後綴的版本在這些地區相依的行為上使用目前的地區設定，而以 _l 後綴版本除了它們會使用傳入的地區設定參數之外運作相同。如需詳細資訊，請參閱地區設定。
如果輸入字串是 NULL，無效參數處理常式會被調用，如 參數驗證 中所述。如果允許繼續執行， errno 會被設置為 EINVAL 且 _MBC_ILLEGAL 會回傳零。
需求
程序 |
必要的標頭檔 |
選擇性標頭 |
|---|---|---|
_mbsbtype |
<mbstring.h> |
<mbctype.h>* |
_mbsbtype_l |
<mbstring.h> |
<mbctype.h>* |
* 的表示常值是用於回傳值。
如需更多關於相容性的資訊，請參閱入門介紹中的 相容性 (Compatibility) 。
.NET Framework 對等用法
不適用，請參閱 System::Globalization::CultureInfo 。