共用方式為

_strdec、 、 _wcsdec、 _mbsdec_mbsdec_l

  • 發行項

將字串指標後移一個字元。

重要

在 Windows 執行階段中執行的應用程式中無法使用 _mbsdec 和 _mbsdec_l。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 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
來源字串current中任何字元的指標（或 為 _mbsdec 和 _mbsdec_l，任何多位元組位元的第一個字節;必須在來源字串中追蹤start。

locale
要使用的地區設定。

傳回值

_mbsdec、 、 和 每個 都會傳回緊接在 前面的current字元指標;_mbsdec如果 的值start大於或等於 的 current，則傳回 。_wcsdec _strdec_mbsdec_lNULL _tcsdec 會對應至其中一個函式，而其傳回值則取決於此對應。

備註

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

輸出值會受到設定地區設定之 LC_CTYPE 類別設定的影響。 如需詳細資訊，請參閱 setlocale和 _wsetlocale。 _mbsdec 會根據目前使用的地區設定來辨識多位元組字元序列，而 _mbsdec_l 與其相同，只不過它會改用傳入的地區設定參數。 如需詳細資訊，請參閱 Locale。

如果 start 或 current 為 NULL，則會叫用無效的參數處理程式，如參數驗證中所述。 若允許繼續執行，此函式會傳回 EINVAL，並將 errno 設為 EINVAL。

重要

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

根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

一般文字常式對應

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 的用法。

// 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