次の方法で共有


_mbsdec、_mbsdec_l、_strdec、_wcsdec

更新 : 2007 年 11 月

文字列ポインタを 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 の使い方は、次のコード例のとおりです。

   const TCHAR *str = _T("some text");
   const TCHAR *str2;
   TCHAR *answer;
   str2 = str;
   str2++;
   answer = _tcsdec( str, str2 );

_mbsdec の使い方は、次のコード例のとおりです。

   char *str = "some text";
   char *str2;
   unsigned char *answer;
   str2 = str; 
   str2++;
   answer = _mbsdec( reinterpret_cast<unsigned char *>( str ), reinterpret_cast<unsigned char *>( str2 ));

.NET Framework の相当するアイテム

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

参照

参照

文字列操作 (CRT)

_mbsinc、_mbsinc_l、_strinc、_wcsinc

_mbsnextc、_mbsnextc_l、_strnextc、_wcsnextc

_mbsninc、_mbsninc_l、_strninc、_wcsninc