_strnextc、 、 _wcsnextc、 _mbsnextc_mbsnextc_l

在字串中尋找下一個字元。

重要

在 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