CW2WEX 類別

字串轉換宏 CW2TEX 和 CT2WEX 和 typedef CW2W 會使用此類別。

重要

這個類別及其成員不能用於在Windows 執行階段中執行的應用程式。

語法

template <int t_nBufferLength = 128>
class CW2WEX

參數

t_nBufferLength
翻譯程式中使用的緩衝區大小。 預設長度為 128 個位元組。

成員

公用建構函式

名稱	描述
CW2WEX：：CW2WEX	建構函式。
CW2WEX：：~CW2WEX	解構函式。

公用運算子

名稱	描述
CW2WEX：：operator LPWSTR	轉換運算子。

公用資料成員

名稱	描述
CW2WEX：：m_psz	儲存來源字串的資料成員。
CW2WEX：：m_szBuffer	用來儲存已轉換字串的靜態緩衝區。

備註

除非需要額外的功能，否則請在程式碼中使用 CW2TEX、CT2WEX 或 CW2W。

這個類別包含固定大小的靜態緩衝區，用來儲存轉換的結果。 如果結果太大而無法放入靜態緩衝區，類別會使用 malloc 配置記憶體，在物件超出範圍時釋放記憶體。 這可確保與舊版 ATL 中可用的文字轉換宏不同，此類別可安全地在迴圈中使用，而且不會溢位堆疊。

如果類別嘗試在堆積上配置記憶體並失敗，則會使用 AtlThrow 引數呼叫 E_OUTOFMEMORY。

根據預設，ATL 轉換類別和宏會使用目前線程的 ANSI 字碼頁進行轉換。

下列宏是以這個類別為基礎：

• CW2TEX

• CT2WEX

下列 typedef 是以這個類別為基礎：

• CW2W

如需這些文字轉換宏的討論，請參閱 ATL 和 MFC 字串轉換宏 。

範例

如需使用這些字串轉換宏的範例，請參閱 ATL 和 MFC 字串轉換宏 。

需求

標頭： atlconv.h

CW2WEX：：CW2WEX

建構函式。

CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR  psz) throw(...);

參數

psz
要轉換的文字字串。

nCodePage
字碼頁。 未用於這個類別。

備註

建立翻譯所需的緩衝區。

CW2WEX：：~CW2WEX

解構函式。。

~CW2WEX() throw();

備註

釋放配置的緩衝區。

CW2WEX：：m_psz

儲存來源字串的資料成員。

LPWSTR m_psz;

CW2WEX：：m_szBuffer

用來儲存已轉換字串的靜態緩衝區。

wchar_t m_szBuffer[t_nBufferLength];

CW2WEX：：operator LPWSTR

轉換運算子。

operator LPWSTR() const throw();

傳回值

以 LPWSTR 類型傳回文字字串。

另請參閱

CA2AEX 類別
CA2CAEX 類別
CA2WEX 類別
CW2AEX 類別
CW2CWEX 類別
類別概觀