_strninc、 _wcsninc、 _mbsninc、 _mbsninc_l

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

構文

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

パラメーター

str
ソース文字列。

count
文字列ポインターをインクリメントする文字数。

locale
使用するロケール。

戻り値

これらの各ルーチンは、指定されたポインターが str の場合に str が count または NULL によってインクリメントされた後、NULL のポインターを返します。 count が str の文字数以上の場合、結果は未定義になります。

解説

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

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

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

_strninc および _wcsninc は、 _mbsnincの 1 バイト文字の文字列とワイド文字の文字列バージョンです。 _wcsninc と _strninc はこのマッピングに対してのみ提供され、それ以外の場合は使用しないでください。 詳細については、「 汎用テキスト マッピングの使用 および Generic-text マッピングの使用を参照してください。

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

要件

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

文字列操作
ロケール
マルチバイト文字のシーケンスの解釈
_strdec、 _wcsdec、 _mbsdec、 _mbsdec_l
_strinc、 _wcsinc、 _mbsinc、 _mbsinc_l
_strnextc、 _wcsnextc、 _mbsnextc、 _mbsnextc_l