_strninc, _wcsninc, _mbsninc, _mbsninc_l

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

重要

_mbsninc および _mbsninc_l は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

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 のグローバル状態」を参照してください。

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

Tchar.h のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_tcsninc	_strninc	_mbsninc	_wcsninc

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

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

必要条件

ルーチンによって返される値	必須ヘッダー
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

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

関連項目

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