_strinc, _wcsinc, _mbsinc, _mbsinc_l

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

重要

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

構文

char *_strinc(
   const char *current,
   _locale_t locale
);
wchar_t *_wcsinc(
   const wchar_t *current,
   _locale_t locale
);
unsigned char *_mbsinc(
   const unsigned char *current
);
unsigned char *_mbsinc_l(
   const unsigned char *current,
   _locale_t locale
);

パラメーター

current
文字ポインター。

locale
使用するロケール。

戻り値

これらの各ルーチンは、current の直後に続く文字へのポインターを返します。

解説

_mbsinc 関数は、current の直後に続くマルチバイト文字の最初のバイトへのポインターを返します。 _mbsinc は、現在使用中のマルチバイト コード ページに従ってマルチバイト文字シーケンスを認識します。_mbsinc_l は、渡されたロケール パラメーターを代わりに使用することを除いて同じものです。 詳細については、「 Locale」を参照してください。

Tchar.h に定義されている汎用テキスト関数 _tcsinc は、_mbsinc にマップされるか (_MBCS が定義されている場合)、または _wcsinc にマップされます (_UNICODE が定義されている場合)。 それ以外の場合、_tcsinc は _strinc に割り当てられます。 _strinc と _wcsinc はそれぞれ、_mbsinc の 1 バイト文字バージョンとワイド文字バージョンです。 _strinc この _wcsinc マッピングに対してのみ提供され、それ以外の場合は使用しないでください。 詳細については、「汎用テキスト マッピングと汎用テキスト マッピングの使用」を参照してください。

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

重要

これらの関数は、バッファー オーバーランの脅威に対して脆弱な場合があります。 バッファー オーバーランは、認められていない特権の昇格の原因となるため、システムの攻撃に使用される可能性があります。 詳細については、「バッファー オーバーランの回避」を参照してください。

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

必要条件

ルーチンによって返される値	必須ヘッダー
_mbsinc	<mbstring.h>
_mbsinc_l	<mbstring.h>
_strinc	<tchar.h>
_wcsinc	<tchar.h>

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

関連項目

文字列操作
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l
_strninc, _wcsninc, _mbsninc, _mbsninc_l