_mbsninc、_mbsninc_l、_strninc、_wcsninc

[アーティクル]
08/09/2011

文字列ポインターを n 文字進めます。

unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);
char *_strninc(
   const char *str,
   size_t count 
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count 
);

パラメーター

str
変換元の文字列。
count
文字列ポインターをインクリメントする文字数。
locale
使用するロケール。

戻り値

これらのルーチンは、str が count 文字数だけインクリメントされた後の str へのポインターを返します。指定されたポインターが NULL の場合は、NULL を返します。 count が str 内の文字数以上の場合、結果は未定義です。

解説

_mbsninc 機能は、count マルチバイト文字で str をインクリメントします。 _mbsninc 関数は、現在使用中のマルチバイトコードページに基づいて、マルチバイト文字列を認識します。

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

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc と _wcsninc は、それぞれ _mbsninc の 1 バイト文字バージョンとワイド文字バージョンです。 _wcsninc と _strninc はこの割り当てにのみ使用し、その他の場合には使用しないでください。詳細については、「汎用テキストマップの使用」および「汎用テキストマップ」を参照してください。

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