_mbsnextc、_mbsnextc_l、_strnextc、_wcsnextc

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

文字列内の次の文字を検索します。

unsigned int _mbsnextc(
   const unsigned char *str 
);
unsigned int _mbsnextc_l(
   const unsigned char *str,
   _locale_t locale
);
unsigned int _strnextc(
   const char *str
);
unsigned int _wscnextc(
   const wchar_t *str
);

パラメータ

str
変換元の文字列。
locale
使用するロケール。

戻り値

これらの関数は、str 内の次の文字の整数値を返します。

解説

_mbsnextc 関数は、文字列ポインタを進めずに、str の次のマルチバイト文字の整数値を返します。_mbsnextc は、現在使用しているマルチバイトコードページに基づいて、マルチバイト文字シーケンスを認識します。

str が NULL の場合は、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、この関数は errno を EINVAL に設定して 0 を返します。

セキュリティに関するメモ この API は、バッファオーバーランが原因で発生する可能性のある問題の影響を受けます。バッファオーバーランは、システムを攻撃するときによく使用される方法であり、その結果、認められていない権限が昇格されます。詳細については、「Avoiding Buffer Overruns」を参照してください。

汎用テキストルーチンのマップ

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc と _wcsnextc は、_mbsnextc の 1 バイト文字列バージョンとワイド文字列バージョンです。_wcsnextc は、string に含まれる次のワイド文字の整数値を返します。_strnextc は、string に含まれる次の 1 バイト文字の整数値を返します。_strnextc と _wcsnextc は、この割り当てのためにのみ使用し、他の場合には使用しません。詳細については、「汎用テキストマップの使用」および「汎用テキストマップ」を参照してください。

_mbsnextc_lは、代わりに渡されるロケールパラメータを使用することを除いて同じです。詳細については、「ロケール」を参照してください。