_strdec、_wcsdec、_mbsdec、_mbsdec_l

文字列のポインターの[戻る] 1 文字を実行します。

重要
mbsdec と mbsdec_l は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW 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 を返します。これらの関数および戻り値の 1 つに_tcsdec のマップは、マッピングによって異なります。

解説

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

出力値は、LC_CTYPE ロケールのカテゴリの設定で決まります。; 詳細については、setlocale、_wsetlocale を参照してください。_mbsdec は現在使用しているロケールに従って _mbsdec_l は同じ点は、マルチバイト文字シーケンスを認識し、代わりに渡されたロケール パラメーターを使用します。詳細については、「ロケール」を参照してください。

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

セキュリティに関するメモ
これらの関数は、バッファー オーバーランの脅威に脆弱な場合があります。バッファー オーバーランは、システムを攻撃に、認められていない特権の昇格となっている可能性があるため、使用できます。詳細については、「Avoiding Buffer Overruns」を参照してください。

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

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsdec	_strdec	_mbsdec	_wcsdec

_strdec と _wcsdec は _mbsdec のバイト文字やワイド文字バージョンと _mbsdec_lです。_strdec と _wcsdec はこの割り当てにのみ使用し、別の方法で使用しないでください。

詳細については、「汎用テキスト マップの使用」および「汎用テキスト マップ」を参照してください。

必要条件

ルーチン	必須ヘッダー	オプション ヘッダー
_mbsdec	<mbstring.h>	<mbctype.h>
_mbsdec_l	<mbstring.h>	<mbctype.h>
_strdec	<tchar.h>
_wcsdec	<tchar.h>

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

使用例

次の例では _tcsdecの使用例を次に示します。

#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の使用例を次に示します。

#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); 
}

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

文字列操作 (CRT)

_strinc、_wcsinc、_mbsinc、_mbsinc_l

_strnextc、_wcsnextc、_mbsnextc、_mbsnextc_l

_strninc、_wcsninc、_mbsninc、_mbsninc_l