_strdec、_wcsdec、_mbsdec、_mbsdec_l

發行項
06/09/2015

將資料指標向後移動一個字元

重要

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 。 _tcsdec 對應到這些函式之一，而它的傳回值取決於對應的函式。

備註

_mbsdec 和 _mbsdec_l 函式會傳回指標緊接在該字串的 current 之前包含 start多位元組字元的第一個位元組。

輸出值受地區設定的 LC_CTYPE 類別設定的設定所影響; 請參閱 setlocale、_wsetlocale 以取得詳細資訊。 _mbsdec 表示根據目前使用的地區設定識別多位元組字元序列，而 _mbsdec_l 除了使用傳遞的地區設定參數之外都相同。如需詳細資訊，請參閱地區設定。

如果 start 或 current 是 NULL，會觸發無效參數處理常式，如參數驗證中所述。如果允許繼續執行，這個函式會傳回 EINVAL，並將 errno 設為 EINVAL。

安全性提示
這些函式可能容易受到緩衝區滿溢的威脅。緩衝區滿溢可能被當成系統攻擊方式，因為它們可能導致非預期的提高權限。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

一般文字常式對應

Tchar.h 常式	未定義 _UNICODE and _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); 
}