_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 はこのマッピングに対してのみ提供され、それ以外の場合は使用しないでください。 詳細については、「 汎用テキスト マッピングの使用 および Generic-text マッピングの使用を参照してください。

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