在字串中尋找下一個字元。
重要
在 Windows 執行階段中執行的應用程式中無法使用 _mbsnextc 和 _mbsnextc_l。 如需詳細資訊,請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。
語法
unsigned int _strnextc(
const char *str
);
unsigned int _wcsnextc(
const wchar_t *str
);
unsigned int _mbsnextc(
const unsigned char *str
);
unsigned int _mbsnextc_l(
const unsigned char *str,
_locale_t locale
);
參數
str
來源字串。
locale
要使用的地區設定。
傳回值
每個函式都會傳回 中下一個字元的 str整數值。
備註
_mbsnextc 函式會傳回 str 中下一個多位元組字元的整數值,不用將字串指標提前。 _mbsnextc 根據目前使用的多位元組字碼頁來辨識多位元組字元序列。
如果 str 為 NULL,將會叫用無效參數處理常式,如參數驗證 (部分機器翻譯) 中所述。 若允許繼續執行,errno 會設為 EINVAL,且此函式會傳回 0。
安全性提示:此 API 可能會帶來因緩衝區溢位問題所引發的威脅。 緩衝區滿溢問題是系統攻擊常見的方法,會造成權限無故提高。 如需詳細資訊,請參閱 Avoiding Buffer Overruns (避免緩衝區滿溢)。
根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
一般文字常式對應
| Tchar.h 常式 | _UNICODE 和 _MBCS 未定義 |
_MBCS 已定義 |
_UNICODE 已定義 |
|---|---|---|---|
_tcsnextc |
_strnextc |
_mbsnextc |
_wcsnextc |
_strnextc 和 _wcsnextc 是的單一位元組字元字串和寬字元字串版本 _mbsnextc。 _wcsnextc 會傳回 str 中下一個寬字元的整數值;_strnextc 會傳回 str 中下一個單位元組字元的整數值。 _strnextc 和 _wcsnextc 僅針對此對應提供,否則不應使用。 如需詳細資訊,請參閱 使用泛型文字對應 和 泛型文字對應。
_mbsnextc_l 也相同,但是它會改用傳入的地區設定參數。 如需詳細資訊,請參閱 Locale。
需求
| 常式 | 必要的標頭 |
|---|---|
_mbsnextc |
<mbstring.h> |
_mbsnextc_l |
<mbstring.h> |
_strnextc |
<tchar.h> |
_wcsnextc |
<tchar.h> |
如需相容性詳細資訊,請參閱相容性。
另請參閱
字串操作
地區設定
多位元組字元序列的解譯
_strdec、 、 _wcsdec、 _mbsdec_mbsdec_l
_strinc、 、 _wcsinc、 _mbsinc_mbsinc_l
_strninc、 、 _wcsninc、 _mbsninc_mbsninc_l