_strdec, _wcsdec, _mbsdec, _mbsdec_l

文字列ポインターを 1 文字前へ移動します。

重要

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

構文

unsigned char *_strdec(
   const unsigned char *start,
   const unsigned char *current
);
unsigned wchar_t *_wcsdec(
   const unsigned wchar_t *start,
   const unsigned wchar_t *current
);
unsigned char *_mbsdec(
   const unsigned char *start,
   const unsigned char *current
);
unsigned char *_mbsdec_l(
   const unsigned char *start,
   const unsigned char *current,
   _locale_t locale
);

パラメーター

start
ソース文字列内の任意の文字 (または_mbsdec_mbsdec_lマルチバイト文字の最初のバイト) へのポインター。ソース文字列startの前に置くcurrent必要があります。

current
ソース文字列内の任意の文字 (または_mbsdec_mbsdec_lマルチバイト文字の最初のバイト) へのポインター。ソース文字列currentの後に続くstart必要があります。

locale
使用するロケール。

戻り値

_mbsdec、_mbsdec_l、_strdecおよび_wcsdec各値が直前の文字current_mbsdecへのポインターを返します。の値が次の値start以上の場合にcurrent返NULLします。 _tcsdec は、これらの関数の 1 つに割り当てられます。戻り値は割り当てによって異なります。

解説

_mbsdec 関数と _mbsdec_l 関数は、current を含む文字列の start に先行するマルチバイト文字の最初のバイトへのポインターを返します。

出力値は、ロケールの LC_CTYPE カテゴリ設定の設定によって影響を受けます。 詳細については、「 setlocale」と「 _wsetlocaleの両方を管理できます。 _mbsdec は、現在使用中のロケールに従ってマルチバイト文字シーケンスを認識します。_mbsdec_l は、渡されたロケール パラメーターを代わりに使用することを除いて同じです。 詳細については、「 Locale」を参照してください。

その場合start、NULLcurrentパラメーターの検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は EINVAL を返し、errno を EINVAL に設定します。

重要

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

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

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

Tchar.h のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_tcsdec	_strdec	_mbsdec	_wcsdec

_strdec と _wcsdec はそれぞれ、_mbsdec と _mbsdec_l の 1 バイト文字バージョンとワイド文字バージョンです。 _strdec この _wcsdec マッピングに対してのみ提供され、それ以外の場合は使用しないでください。

詳細については、「汎用テキスト マッピングと汎用テキスト マッピングの使用」を参照してください。

必要条件

ルーチンによって返される値	必須ヘッダー	オプション ヘッダー
_mbsdec	<mbstring.h>	<mbctype.h>
_mbsdec_l	<mbstring.h>	<mbctype.h>
_strdec	<tchar.h>
_wcsdec	<tchar.h>

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

例

_tcsdec を使用する例を次に示します。

// crt_tcsdec.cpp
// Compile by using: cl /EHsc crt_tcsdec.cpp
#include <iostream>
#include <tchar.h>
using namespace std;

int main()
{
   const TCHAR *str = _T("12345");
   cout << "str: " << str << endl;

   const TCHAR *str2;
   str2 = str + 2;
   cout << "str2: " << str2 << endl;

   TCHAR *answer;
   answer = _tcsdec( str, str2 );
   cout << "answer: " << answer << endl;

   return (0);
}

_mbsdec を使用する例を次に示します。

// crt_mbsdec.cpp
// Compile by using: cl /EHsc crt_mbsdec.c
#include <iostream>
#include <mbstring.h>
using namespace std;

int main()
{
   char *str = "12345";
   cout << "str: " << str << endl;

   char *str2;
   str2 = str + 2;
   cout << "str2: " << str2 << endl;

   unsigned char *answer;
   answer = _mbsdec( reinterpret_cast<unsigned char *>( str ), reinterpret_cast<unsigned char *>( str2 ));

   cout << "answer: " << answer << endl;

   return (0);
}

関連項目

文字列操作
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l
_strninc, _wcsninc, _mbsninc, _mbsninc_l