_mbsninc、_mbsninc_l、_strninc、_wcsninc

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

更新 : 2007 年 11 月

文字列ポインタを 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 は、代わりに渡されるロケールパラメータを使用することを除いて同じです。詳細については、「ロケール」を参照してください。