CA2AEX 类

此类由字符串转换宏 CA2TEX 和 CT2AEX 以及 typedef CA2A 使用。

重要

无法在 Windows 运行时中执行的应用程序中使用此类及其成员。

语法

template <int t_nBufferLength = 128>
class CA2AEX

参数

t_nBufferLength
转换过程中使用的缓冲区的大小。 默认长度为 128 字节。

成员

公共构造函数

名称	描述
CA2AEX::CA2AEX	构造函数。
CA2AEX::~CA2AEX	析构函数。

公共运算符

“属性”	描述
CA2AEX::operator LPSTR	转换运算符。

公共数据成员

“属性”	描述
CA2AEX::m_psz	存储源字符串的数据成员。
CA2AEX::m_szBuffer	用于存储转换后的字符串的静态缓冲区。

注解

除非需要额外的功能，否则请在代码中使用 CA2TEX、CT2AEX 或 CA2A。

此类包含固定大小的静态缓冲区，用于存储转换结果。 如果结果过大，无法放入静态缓冲区，则该类将使用 malloc 分配内存，并在对象超出范围时释放内存。 不同于早期版本的 ATL 中提供的文本转换宏，这可确保此类可以安全用于循环中且不会溢出堆栈。

如果此类尝试在堆上分配内存并失败，它将使用 E_OUTOFMEMORY 的参数调用 AtlThrow。

默认情况下，ATL 转换类和宏将使用当前线程的 ANSI 代码页进行转换。

以下宏基于此类：

• CA2TEX

• CT2AEX

以下 typedef 基于此类：

• CA2A

有关这些文本转换宏的讨论，请参阅 ATL 和 MFC 字符串转换宏。

示例

有关使用这些字符串转换宏的示例，请参阅 ATL 和 MFC 字符串转换宏。

要求

标头：atlconv.h

CA2AEX::CA2AEX

构造函数。

CA2AEX(LPCSTR psz, UINT nCodePage) throw(...);
CA2AEX(LPCSTR psz) throw(...);

参数

psz
要转换的文本字符串。

nCodePage
未用于此类。

注解

创建转换所需的缓冲区。

CA2AEX::~CA2AEX

析构函数。

~CA2AEX() throw();

备注

释放分配的缓冲区。

CA2AEX::m_psz

存储源字符串的数据成员。

LPSTR m_psz;

CA2AEX::m_szBuffer

用于存储转换后的字符串的静态缓冲区。

char m_szBuffer[ t_nBufferLength];

CA2AEX::operator LPSTR

转换运算符。

operator LPSTR() const throw();

返回值

返回 LPSTR 类型的文本字符串。

另请参阅

CA2CAEX 类
CA2WEX 类
CW2AEX 类
CW2CWEX 类
CW2WEX 类
类概述