_mbsdec、_mbsdec_l、_strdec、_wcsdec

[アーティクル]
08/09/2011

文字列ポインターを 1 文字戻します。

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
ソース文字列の任意のマルチバイト文字の最初のバイトへのポインター。ソース文字列内で、start は current の前にあることが必要です。
current
ソース文字列の任意のマルチバイト文字の最初のバイトへのポインター。ソース文字列内で、current は start の後に来ることが必要です。
locale
使用するロケール。

戻り値

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

解説

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

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

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

セキュリティに関するメモ この API は、バッファーオーバーランが原因で発生する可能性のある問題の影響を受けます。バッファーオーバーランは、システムを攻撃するときによく使用される方法であり、その結果、認められていない権限が昇格されます。詳細については、「Avoiding Buffer Overruns」を参照してください。

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

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>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

次の例では_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); 
}