深入解析ATL(第二版ATL8.0)(2.1-2.2节)

第二章 字符串和文本

翻译:赖仪灵
出处:http://blog.csdn.net/laiyiling, http://www.cppblog.com/techlab
声明:版权归原作者拥有,请勿随意转载此翻译文档,保留一切权利。

字符串引入了多种不同的字符集。COM组件通常需要使用多个不同的字符集,并在不同的字符集之间相互转换。ATL提供了一些字符串转换类,需要时这些类会自动把字符集进行转换,如果不需要,它们什么也不做。

CComBSTR类是一个智能字符串类。它能完全根据BSTR字符串的含义进行分配、拷贝和释放字符串。CComBSTR实例可以用于大部分使用BSTR的地方,但不是所有地方都合适。

CString类是ATL新增的一个类,来源于MFC。此类可以处理分配、拷贝、格式化,以及很多的高级字符串处理特征。它可以管理ANSI和Unicode数据,以及在处理自动化方法参数时可以同BSTR字符串相互转换。通过CString类,你甚至可以控制、自定义类中字符串数据的内存管理方法。

2.1 字符串数据类型、转换类和辅助函数

2.1.1 回顾文本数据类型

在C++编程中处理文本数据类型是有点头痛的。主要的问题是文本数据类型不止一种,而是多种。这里使用文本数据类型(Text data type)指一般意义上的字符数组。通常,除了把字符数组当作文本字符串外,不同的操作系统和编程语言还给字符数组赋予了其他不同的含义(比如:NUL终止字符或者长度前缀)。

在选择文本数据类型时,我们需要做几个决定。第一:决定数组由什么字符类型组成。当我们向操作系统传递字符串时(比如文件名称),有的系统要求使用ANSI字符,有的系统要求使用EBCDID字符,有的既可以使用ANSI,也可以使用Unicode字符。有时还会使用特殊的字符集,比如多/双字节字符集(MBCS/DBCS),对它们的细节本书不做讨论。

第二:你必须考虑在程序中希望使用什么字符集来操作文本。源代码使用的字符集并不一定要与运行程序的操作系统默认字符集相同。当然,使用相同的字符集会更方便;但是程序和操作系统应该可以使用不同的字符集。我们必须“简单地”转换操作系统传入、传出的所有字符串。

第三:必须决定文本字符串的长度。一些语言如C和C++,以及一些操作系统如Windows 9X/NT/XP和UNIX,使用结束字符NUL来划定文本字符串的结尾。其他语言如Microsoft的Visual Basic解释器、Microsoft的JAVA虚拟机、Pascal更愿意用一个明确的前缀长度指明文本字符串的字符个数。

第四:在实际中,文本字符串带来的资源管理问题。文本字符串的长度一般不同。这样就很难在栈上给字符串分配内存,而且文本字符串也可能根本不适合在栈上。所以,文本字符串通常是动态分配的。理所当然,这就要求在最后释放文本字符串。资源管理引出了文本字符串所有者的概念。只有所有者才能释放字符串仅此一次。在不同的组件之间传递文本字符串时所有权变得非常重要。

更糟糕的是,两个COM对象可以位于两台不同的计算机上,而且他们运行着不同的操作系统,甚至文本字符串的字符集也是不同的。比如你可以用Visual Basic编写一个运行在Windows XP上的COM对象。我们可能把文本字符串传递到另一个用C++编写的运行在IBM主机上的COM对象。因此,我们需要一个标准的文本数据类型,使得不同环境的COM对象都能够理解。

COM使用OLECHAR字符数据类型。COM文本字符串是一个以NUL字符结尾的OLECHAR字符数组;指向字符串的指针是LPOLECHAR。作为规则,COM接口的文本字符串参数必须用LPOLESTR类型。当方法没有改变字符串时,参数应该是LPCOLESTR类型,也就是一个OLECHAR字符数组的常量指针。

大多数情况下(并不是所有),OLECHAR类型和我们编写代码时用的字符类型不同。有时候(并不是所有)OLECHAR类型和我们传递给操作系统的字符类型也不相同。这就意味着,根据不同的要求,有时候需要把一种文本字符串转为其他的字符集,有时候又不需要。

不幸的是,编译选项的改变(如Windows XP Unicode编译或者Windows CE编译)可能改变这种要求。因为,之前不需要转换的字符串现在可能需要转换,或者相反。我们当然不希望在改变编译选项的时候就重新编写全部的代码。因此,ATL提供了一些方便的字符串转换宏,实现文本字符串不同字符集之间的转换,并且能根据调用转换的要求作出相应变化。

Windows字符数据类型

现在,我们集中在Windows平台。基于Windows的COM组件通常混合使用下面的四种文本数据类型:
1)、Unicode、一种描述16位多语言字符编码的字符规范,也称“宽字符”。Windows NT/XP操作系统内部就是使用Unicode字符集。现代计算机上使用的所有字符,包括技术符号和特殊出版字符,都可以在Unicode中唯一描述。固定的字符大小可以简化使用国际化字符集时的编程工作。在C/C++语言中,用wchar_t数组描述宽字符的字符串,对应的字符串指针类型是wchar_t*。
2)、MBCS/DBCS、多字节字符集是一种混合宽度字符集,其中的一些字符由不止一个字节组成。一般,Windows 9X操作系统使用MBCS来描述字符。双字节字符集(DBCS)是一种特殊的多字节字符集类型。它包含一些单字节的字节和一些描述特殊区域的符号的双字节字符。比如日、中文和韩文。

在C/C++语言中,我们使用unsigned char类型的数组表示MBCS/DBCS字符串,对应的指针类型是unsigned char*。有时候,一个字符的长度是一个unsigned char,有时候不止一个。它使得字符串的处理很有意思,特别是试图通过字符串进行回退工作时。在Visual C++中,MBCS始终等于DBCS。现在字符集还不支持超过两个字节的字符。

3)、ANSI、在英语中,我们可以描述所有的字符,包括一些西欧语言,仅仅使用8比特。支持这种语言的Windows版本使用了一种退化的MBCS版本,称为Microsoft Windows ANSI字符集,它当中没有多字节字符存在。Microsoft Windows ANSI字符集是ISO 8859/X的核心加上一些附加字符,最初是基于ANSI草案标准的。

ANSI字符集把字母和数字按照ASCII同样的方式进行映射。但是,ANSI不支持控制字符,不能映射一些符号,包括重音字母,都没有映射到标准ASCII。所有的Windows字体都是定义在ANSI字符集。为了对应,ANSI也称为单字节字符集(SBCS)。

在C/C++中,我们用char数组表示ANSI字符串,对应的指针类型的char*。每个字符都总是一个char长度。Visual C++中char默认为signed char。因为MBCS字符是unsigned而ANSI字符默认是signed字符,与使用MBCS字符相比,使用ANSI字符的表达式可以进行不同的求值。

4)、TCHAR/_TCHAR、它是Microsoft一种特殊的普通文本数据类型,可以根据编译选项映射为Unicode字符、MBCS字符、ANSI字符。使用这种字符类型进行一般的编码可以编译为上述三种字符集任何一种。它简化了国际化市场的代码开发。C运行库定义了_TCHAR类型,而Windows操作系统则定义为TCHAR类型,它们的相同的。

Microsoft特有的C运行库头文件tchar.h,定义了特殊文本数据类型_TCHAR。ANSI C/C++编译器依从了实现器的命名需求:以下划线做前缀。当我们没有定义__STDC__预编译符号时(Visual C++默认没有定义此符号),表示我们不需要ANSI顺从命名需求。在这种情况下,如果特殊文本数据类型的名称没有定义,tchar.h文件也会定义了另外一个符号TCHAR作为其别名。winnt.h也是Microsoft特有的Win32操作系统头文件,定义特殊文本数据类型为TCHAR。此文件是操作系统特有的,因此这个符号不需要使用下划线前缀。

Win32 APIs和字符串

所有需要字符串参数的Win32 API都有两个版本:一个需要Unicode参数,另一个需要MBCS参数。在不能使用MBCS的Windows版本中,MBCS版本的API使用ANSI参数。比如,SetWindowText函数实际上是不存在的。实际上有两个函数:SetWindowTextW,需要Unicode字符串参数;SetWindowTextA,需要MBCS/ANSI字符串参数。

在Windows NT/2000/XP操作系统内部实际上只使用Unicode字符串。因此,当我们在系统Windows NT/2000/XP上调用SetWindowTextA时,函数会把指定的字符串转换为Unicode然后再调用SetWindowTextW。Windows 9X操作系统不能直接支持Unicode。在操作系统Windows 9X上,当SetWindowTextW返回错误时,SetWindowTextA就会被调用工作。微软的MSLU库提供了Win9X上几乎所有Unicode函数的实现。

现在,我们就面临一个艰难的决策。我们可以用Unicode编码字符串编写高效的组件,只能在Windows 2000以上而不能在Windows 9X运行。可以用Unicode字符串的MSLU编码,可以运行在两种平台,只是在Windows 9X下会有性能影响。可以用MBCS/ANSI编码字符串编写更通用的组件,可以运行在两种平台,只是在Windows 2000上不会有性能提高。做为选择,我们不需要直接回答,而是在编程源代码的过程中来决定编译时支持什么类型的字符集。

通过一些编码标准和预处理方法,使我们编码时好像只有单个API函数 SetWindowText,而它需要TCHAR类型的字符串参数。我们可以在编译时指定想要编译什么类型的组件。比如,编码调用SetWindowText函数同时指定一个TCHAR缓冲。当把组件编译为Unicode时,调用SetWindowTextW,参数是wchar_t缓冲。当把组件编译为MBCS/ANSI时,调用的是SetWindowTextA,参数是char缓冲。

当编写基于Windows的COM组件时,我们一般应该使用TCHAR字符类型来描述组件内部使用的字符。此外,与操作系统交互的所有字符也都应该使用TCHAR。同样地,应该使用TEXT或者__TEXT宏包围所有的文字字符或字符串。

在tchar.h中定义了功能相同的宏_T、__T、_TEXT,这些宏把字符或者字符串编译为通用文本字符或者文字。winnt.h也定义了功能相同的宏TEXT、__TEXT,它们仍然与_T、__T和_TEXT一样。(这里仅仅是用五种相同的方法完成同样的功能。)在本章的例子使用__TEXT,因为它是在winnt.h中定义。我更愿意使用_T,因为它使源代码更简洁。

如果编码时不知道操作系统,那么我们更倾向于包含tchar.h,使用_TCHAR通用文本数据类型,因为这样可以稍微减少和操作系统的捆绑程度。但是,我们讨论的是在编译时、给特定的操作系统版本用最优化的文本处理方法建立组件。这就要求我们使用在winnt.h中定义的TCHAR数据类型。而且,TCHAR没有_TCHAR那么刺眼,也更容易输入。大多数代码已经通过windows.h隐式的包含了winnt.h,而tchar.h是必须显式包含的。各种各样的优点都支持使用TCHAR,因此在本书的例子中,使用它作为通用文本数据类型。

这就表示我们可以为不同的市场需求或者效率原因编译特殊版本的组件。这些类型和宏定义在winnt.h头文件。

在操作TCHAR类型的字符串时,我们也必须使用不同字符串运行库函数集合。我们熟悉的函数strlen、strcpy等等只能处理char字符类型。稍微陌生的函数wcslen、wcscpy等函数操作wchar_t类型字符。而且,我们更为陌生的_mbslen、_mbscpy等函数能处理多字节字符类型。因为TCHAR有时是wchar_t类型,有时是保存ANSI自负的char类型,有时是保存多字节字符(通常是unsigned)的char类型。我们需要一个相应的能处理TCHAR字符类型的函数集合。

在tchar.h头文件中定义了很多有用的通用文本映射字符串操作函数。这些函数使用TCHAR类型做参数,因此这些函数都用_tcs作名称前缀(_t字符集)。比如,_tcslen与C运行库的函数strlen相同。_tcslen函数使用TCHAR参数,而strlen函数用char字符做参数。

用预处理控制通用文本映射

两个预处理符号和宏控制了TCHAR数据类型到应用程序内部实际使用类型的映射关系。

UNICODE/_UNICODE:Windows操作系统API的头文件使用UNICOD预处理符号。C/C++运行库头文件使用_UNICODE符号。特别的是,我们可以同时定义这两个符合,也可以一个也不定义。当使用_UNICODE符号编译时,tchar.h把TCHAR映射为wchar_t字符。每个字符的前缀宏_T、__T、_TEXT,或者字符串字母的前的大写字母L(分别创建Unicode字符或字母)。当使用wnnt.h定义的UNICODE符号编译时,TCHAR字符被映射为wchar_t字符。_TEXT和__TEXT宏作为字符串前缀或者字符串字母前的大写字母L(分别创建Unicode字符或字母)。_tcsXXX系列函数也被映射到相应的_wcsXXX函数。

_MBCS:当使用定义的_MBCS符号编译时,所有的TCHAR字符都映射为char字符,预处理器会忽略所有的_T和__TEXT宏变量,保持字符或者字母不变(分别创建ANSI字符或字母)。_tcsXX函数被映射到相应的strXXX函数。

我们可以使用通用文本数据类型和函数编写通用文本兼容的代码。下面是一个反转和连接通用文本字符串数据的例子:

TCHAR *reversedString, *sourceString, *completeString;
reversedString = _tcsrev (sourceString);
completeString = _tcscat (reversedString, __TEXT("suffix"));

当我们在没有定义任何预处理符号时编译上面的代码,预处理会产生下面的输出:

char *reversedString, *sourceString, *completeString;
reversedString = _strrev (sourceString);
completeString = strcat (reversedString, "suffix");

当我们定义_UNICODE预处理符号再编译时,预处理会产生如下的输出:

wchar_t *reversedString, *sourceString, *completeString;
reversedString = _wcsrev (sourceString);
completeString = wcscat (reversedString, L"suffix");

当我们定义_MBCS预处理符号再编译时,预处理会产生如下的输出:

char *reversedString, *sourceString, *completeString;
reversedString = _mbsrev (sourceString);
completeString = _mbscat (reversedString, "suffix");

COM字符数据类型Win16

COM使用两种字符数据类型:

OLECHAR:我们在操作系统上编译代码时COM使用此种数据类型。对于Win32操作系统,它是wchar_t字符数据类型,对Win16类型,是char字符类型。对于Mac OS是char字符类型。对于Solaris OS是wchar_t字符类型。对于仍然未知的操作系统,也许有人知道。现在就让我们假想有一种抽象数据类型称为OLECHAR。COM使用它,不取决于它映射到何种特殊的内部数据类型。

BSTR:一些COM组件使用的特殊字符串类型。BSTR是一种带长度前缀、带许多特殊语义的OLECHAR字符数组。

现在,让我们看看稍微复杂点的情况:我们希望编写能在编译时选择使用字符类型的代码。因此,我们在内部进行严格的TCHAR字符串操作。如果希望调用COM方法,并传递一些字符串。我们必须根据方法的参数给其传递OLECHAR或者BSTR字符串。我们的组件所使用的字符串也许会,也许不会是正确的字符格式,这取决于编译选项。这些工作都是由超级宏完成。

ATL字符串转换类

ATL提供了许多的字符串转换类,必要时在我们前述的各种字符类型之间转换。如果编译选项使得源、目的字符类型相同,那么这些类不执行任何转换。在atlconv.h文件中实现了几种不同的转换逻辑,头文件也使用typedef和预处理#define语句,以使我们在使用这些转换类时能更加方便。这些类命名时都使用了各种字符数据类型的缩写:

T表示一个指向Win32的TCHAR字符的指针,典型的LPTSTR参数。
W表示一个指向Unicode的wchar_t字符的指针,典型的LPWSTR参数。
A表示一个指向MBCS/ANSI的char字符的指针,典型的LPSTR参数。
OLE表示一个指向COM OLECHAR字符的指针,典型的LPOLESTR参数。
C表示C/C++的const修饰符。

所有的类名称都采用统一的C <源格式缩写> 2 <目标缩写> 格式。比如,CA2W类把LPSTR转为LPWSTR。当在名称当中有C(不包括第一C它代表类)时,就给缩写添加了一个const修饰符。比如CT2CW类把LPTSTR转为LPCWSTR。

这些类的实际行为取决于我们定义的预处理符号(参考表2.1)。注意ATL转换类和宏把OLE和W等同对待。

表2.1 字符集预处理符号
定义的预处理符号 T转为… OLE转为…
None A W
_UNICODE W W

表2.2列出了ATL的字符转换宏。


如你所见,表2.2没有列出BSTR字符转换类。本章的下一节会介绍CComBSTR类,它实现了一种BSTR类型转换的首选机制。

查看atlconv.h头文件的内容,你就会发现一些类的定义实际上调用了六个比较小的类。比如,当定义了_UNICODE时,CT2A变为CW2A,而CW2A本身是CW2AEX模板类的typedef定义。类型定义仅仅应用到CW2AEX的模板参数。另外,前面所有类名总是把OLE映射为W,因此COLE2T变为CW2T,在Unicode编译是它被定义为CW2W。因为CW2W的源、目标类型相同,因此实际上并不需要进行转换。最后,唯一的六个模板类是:CA2AEX、CA2CAEX、CA2WEX、CW2AEX、CW2CWEX和CW2WEX。只有CA2WEX和CW2AEX有不同的源和目的类型,因此实际上只有这两个类完成实际的工作。因此,我们在表2.2列出的所有转换类最后都会被扩展为这唯一的两个类。这两个类的定义和实现原理相同,因为我们明白了CA2WEX就能明白另一个类的原理。

template< int t_nBufferLength = 128 >
class CA2WEX {
CA2WEX( LPCSTR psz );
CA2WEX( LPCSTR psz, UINT nCodePage );
...
public:
LPWSTR m_psz;
wchar_t m_szBuffer[t_nBufferLength];
...
};

类的定义实际上非常简单。模板参数指定了保存字符串数据的固定静态缓存区的大小。这表示大部分的字符串转换操作都不需要再分配动态内存就能完成。如果字符串转换的请求超过了模板参数的大小,CA2WEX使用malloc分配其他的空间。

CA2WEX提供了两个构造函数。一个接受LPCSTR参数并用Win32 API函数MultiByteToWideChar执行转换工作。默认时,类使用ANSI代码页作为当前本地线程执行转换。第二个构造函数允许指定预备的代码页管理如何执行转换。这个值被直接传递给MultiByteToWideChar,可以参考在线文档,了解关于各种Win32字符转换函数接受的代码页的细节信息。

使用这个转换类的最简单方法就是接受缓存区的默认大小参数。因此,ATL提供了简单的typedef定义来简化它:

typedef CA2WEX<> CA2W;

使用这个转换类,我们只需要像下面这样写简单的代码:
void PutName (LPCWSTR lpwszName);

void PutName(LPCSTR lpsz) {
PutName(CA2W(lpsz));
}

在实际运用中,另外两种情况也比较常见:

1.接受通用文本字符串,传递给需要OLESTR为输入参数的方法。
2.接受OLESTR,传递给需要通用文本字符串为输入参数的方法。

转换类也可以很容易的应付这两种情况:

void PutAddress(LPOLESTR lpszAddress);

void RegisterAddress(LPTSTR lpsz) {
PutAddress(CT2OLE(lpsz));
}

void PutNickName(LPTSTR lpszName);

void RegisterAddress(LPOLESTR lpsz) {
PutNickName(COLE2T(lpsz));
}

内存管理要点

虽然这些转换类是非常的方便,但是如果使用不正确我们就可能陷入到它的一些缺陷当中。转换类为这些转换后的字符串分配内存,在类的析构函数里释放。这对我们非常有用,我们就不需要在担心内存分配的问题了。但是,这也意味着像下面这样的代码会发生崩溃:

LPOLESTR ConvertString(LPTSTR lpsz) {
return CT2OLE(lpsz);
}

上面我们返回了一个指向调用函数栈的指针(它在函数返回前失效)。如果字符串是临时的,或者指针指向的是栈的数组,它们都将在函数返回前被释放。

最糟糕的是:根据我们宏选择的不同,代码也许会工作正常,也可能会在第一次从ANSI转换到UNICODE时发生崩溃(通常在发布的前两天)。为了避免这种情况,当我们在不止一个语句需要时,应该确保把转换后的字符串拷贝到另外的缓冲(或者使用字符串类)。

ATL字符串辅助函数

有时如果希望拷贝一个OLECHAR字符的字符串。碰巧你也知道OLECHAR字符在Win32操作系统上就是宽字符。当编写Win32版本的组件时,可能需要调用Win32操作系统函数lstrcpyW,它实现拷贝宽字符。不幸的是,Windows NT/2000支持Unicode,实现了lstrcpyW,但是Windows 95不支持。使用了lstrcpyW函数的组件在Win95上不能正常运行。

作为代替lstrcpyW,可以使用ATL的字符串辅助函数ocscpy拷贝OLECHAR字符串。它能在Windows NT/2000和Windows 95上正常工作。ATL字符串辅助函数ocslen返回OLECHAR字符串的长度。尽管它替代的lstrlenW函数可以在两个系统上运行,但是为了对称考虑,我们仍然使用ocslen函数。

OLECHAR* ocscpy(LPOLESTR dest, LPOLESTR src);
size_t ocslen(LPCOLESTR s);

同样的,Win32的CharNextW操作系统函数也不能在Win95上运行。因此,ATL提供CharNext0字符串辅助函数,以实现OLECHAR*字符串的递增,返回指向下一个字符。它不会递增超过NUL终止字符的指针。

LPOLESTR CharNext0(LPCOLESTR lp);

ATL字符串转换宏

前面讨论的字符串转换类是在ATL 7引入。ATL 3使用了一系列的宏代替实现。事实上,这些宏仍然在ATL基础代码中使用。比如,下面就是atlctl.h文件的部分内容:

STDMETHOD(Help)(LPCOLESTR pszHelpDir) {
T* pT = static_cast (this);
USES_CONVERSION;
ATLTRACE(atlTraceControls,2,
_T("IPropertyPageImpl::Help/n"));
CComBSTR szFullFileName(pszHelpDir);
CComHeapPtr
pszFileName(LoadStringHelper(pT->m_dwHelpFileID));
if (pszFileName == NULL)
return E_OUTOFMEMORY;
szFullFileName.Append(OLESTR("//"));
szFullFileName.Append(pszFileName);
WinHelp(pT->m_hWnd, OLE2CT(szFullFileName),
HELP_CONTEXTPOPUP, NULL);
return S_OK;
}

这些宏与转换类非常相似,除了开始的字母C是宏名称非类名。因此,把tchar转换为olechar应使用T20LE(s)。

在转换宏和类之间主要有两个区别。第一,宏需要一些本地变量才能工作;USES_CONVERSION宏在使用转换宏的所有地方都需要(它声明本地变量)。第二个不同点是转换缓存的位置。

在转换类中,如果缓存不大,则是以成员变量存储在栈上,如果太大则是存储在堆。而转换宏总是使用栈存储。它们调用运行时函数_alloca来在本地栈上分配额外空间。

尽管_alloca速度很快,仍有一些严重的确定。栈空间会在函数结束后释放,因此如果在循环中使用转换,程序可能会因栈空间用尽而崩溃。







2.2 智能的BSTR封装类CComBSTR

2.2.1 COM字符串数据类型回顾:BSTR

COM是一种语言独立,硬件结构独立的模型。因此,它需要语言独立、硬件结构独立的文本数据类型。COM定义了一种特殊文本数据类型OLECHAR,用来描述COM在特殊平台上使用的文本数据。在多数平台,包括所有的Win32 Windows平台,OLECHAR数据类型是由wchar_t数据类型用typedef定义得来。也就是说,在大多数平台,COM文本数据类型与C/C++的宽字符数据类型,包括Unicode字符是相等的。在另一些平台,比如在16位的Windows操作系统,OLECHAR是标准C数据类型,包括ANSI字符,用typedef定义。一般,我们应该把所有的COM接口字符串参数定义位OLECHAR*类型。

COM也定义了另一种称为BSTR的文本数据类型。BSTR是一个带长度前缀的OLECHAR类型字符串。从效率上考虑,大多数的解释环境更愿意使用长度前缀的字符串。比如,带长度前缀的字符串不需要耗时进行扫描查找NUL结束字符来判断字符串的长度。事实上,NUL结束字符是一种语言特有概念,最开始属于C/C++语言特有的。Microsoft Visual Basic解释器、Microsoft Java虚拟机和大多数的脚本语言,比如VBScript和Jscript内部都使用BSTR表示字符串。

因此,当我们从一个C/C++定义的接口组件中的某个方法传递或者接收字符串时,通常应该使用OLECHAR*数据类型。但是,如果需要使用其他语言定义的接口,一般来说字符串参数应该是BSTR数据类型。关于BSTR数据类型有很多文档化的、难懂的语义说明,使我们使用BSTR变得很繁重,对C++开发人员来说也很容易发生错误。

BSTR类型有如下的属性:

1、BSTR是指针,指向一个带长度前缀的OLECHAR字符数组。
2、BSTR是指针数据类型。它指向数组的第一个字符。长度是以整数存储在数组中紧接第一个字符前面的位置。
3、字符数组是以NUL字符结尾的。
4、前缀长度以字节位单位,不是字符,不包括结束字符NUL。
5、在字符数组内部可能包括有效的NUL字符。
6、BSTR必须使用SysAllocString和SysFreeString函数族进行分配和释放。
7、NULL的BSTR指针表示空字符串
8、BSTR是非引用计数的,因此,两次引用同一字符串的内容必须指向两个单独的BSTR。换句话说,拷贝一个BSTR暗示字符串的复制操作,而不是简单的拷贝指针。

正因为这些专用语义繁多,把这些细节都封装成一个可重用类将非常有用。ATL就提供了这样的类:CComBSTR。


  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
中文名: 深入解析ATL(第2版) 原名: ATL Internals, 2nd Edition Working with ATL 8 别名: ATL 作者: (美)塔瓦瑞斯译者: 赖仪灵 曹雨田 资源格式: PDF 版本: 扫描版 出版社: 电子工业出版社书号: 9787121049859发行时间: 2007年11月01日 地区: 大陆 语言: 简体中文 简介: 编辑推荐 ATL的发明人Jim Springfield亲自作序推荐。   四位顶尖的Windows编程专家倾力合作,绝对经典再现。   COM、ATL开发人员的必备宝典。   深入分析ATL实现COM内幕细,展示COM应用中的各类漂亮技巧。   ATL的经典指南现已更新到ATL 8和VisuaI Studio 2005:   四位顶尖的Windows编程专家在本书中系统地揭示了ATL的内部工作原理,他们解释了ATL是 如何工作的,以及为什么要以这样的方式工作。通过本书,客户端开发人员可以掌握ATL中的窗口、COM控件、MFC集成、Web服务代理生成等资源。服务端编程人员可以应用ATL的全COM服务器和对象服务、高吞吐量、高并发Web应用程序和服务的广泛支持。每个Windows开发人员都将从本书中学到强大的方法来增加应用程序的灵活性、减少负载、最大化程序的透明度和可控性。   ·通过图表、示例代码和ATL的内部实现代码来揭密ATL的内部原理。   ·遍历向导以简化在普通应用程序中的ATL开发。   ·掌握C++、COM和ATL中的字符串使用技巧。   ·利用ATL的智能类型:CComPtr、CComQIPtr、CComBSTR和CComVariant。   ·理解并正确实现IUnknown。   ·创建能从COM服务器中暴露COM对象的粘合代码。   ·使用Canned Interface实现来支持对象的永久性、COM集合、枚举器和连接点。   ·使用ATL窗口类和控件建立独立的应用程序和UI组件。   ·使用ATL Servet开发可以运行在微软IIS上的Web应用程序。 虽然.NET系统从1998年才开始其发展进程。但它已经使很多开发人员的编程发生了革命性的变化,并在未来几年将持续得到改进。但是,COM编程(和 ATL)也依然非常有活力,对Microsoft内外的很多开发人员都非常重要。本书的第2版,与第1版一样,提供了您所需要的信息,使我们在这些技术上的投资也将获得最大的回报。                        ——Jim Springfield,ATL发明人 虽然ATL比较精深,但是这本书的讲解非常通俗易懂,语言比较简练,条理非常清楚。即使在读完这本书之后,它仍然可以作为参考书指导我们的开发和学习工作。我想,这就是好书的价值所在吧。            ——潘爱民,经典畅销书《深入解析Windows操作系统,第4版》译者 内容简介 本书主要介绍了ATL技术的原理、内部实现和应用技巧,由当今4 位顶尖的 Windows技术专家联合撰写。全书内容丰富,深入浅出,主要涵盖了ATL内部架构和实现方法、运用向导简化ATL开发、C++/COM/ATL中字符串的使用技巧、理解并正确实现IUnknown、充分利用ATL提供的Smart Types、撰写能够暴露COM服务器上COM对象的粘合代码、利用Canned Interface实现来支持对象持久化/COM群集/枚举、利用ATL Windows类建构独立的应用程序和UI组件等的技术内容。本书适合于广大Windows开发人员阅读参考,是ATL开发人员的必备权威参考书籍。 作者简介 Christopher Tavares,目前在微软工作,是模式与实践方面的专家。有着超过25年的编程经验,涉及的平台从Sinclair ZX-81到多CPU信号处理硬件。 目录: 第2版序 第1版序 前言 致谢 关于作者 联系博文视点 第1章 你好,ATL 1.1 什么是ATL 1.2 创建COM服务器 1.3 插入COM类 1.4 添加属性和方法 1.5 实现附加接口 1.6 脚本支持 1.7 添加永久性 1.8 添加和激发事件 1.9 使用窗口 1.10 COM控件 1.11 容纳控件 1.12 ATL Server Web项目 1.13 总结 第2章 字符串和文本 2.1 字符串数据类型、转换类和辅助函数 2.2 智能BSTR类CComBSTR 2.3 CComBSTR类 2.4 CString类 2.5 总结 第3章 ATL智能类型 3.1 智能VARIANT类CComVariant 3.2 智能SAFEARRAY类CComSafeArray 3.3 智能指针类CComPtr和CComQIPtr 3.4 智能指针类CAutoPtr和CAutoVectorPtr 3.5 ATL内存管理器 3.6 总结 第4章 ATL中的对象 4.1 实现IUnknown 4.2 ATL的层次 4.3 线程模型支持 4.4 IUnknow核心 4.5 我们的类 4.6 CComObject以及其他 4.7 ATL创建者 4.8 调试 4.9 总结 第5章 COM服务器 5.1 回顾COM服务器 5.2 对象映射表和CAtlModule类 5.3 对象映射表 5.4 对象映射类要求的方法 5.5 CAtlModule类 5.6 重游CComCoClass 5.7 ATL与C运行时库 5.8 总结 第6章 接口映射表 6.1 回顾:COM的实体身份 6.2 表驱动的QueryInterface 6.3 多重继承 6.4 Tear-off接口 6.5 聚合:外部控制对象 6.6 接口映射表链 6.7 尽管说“不” 6.8 调试 6.9 扩展性 6.10 总结 第7章 ATL中的永久性 7.1 回顾COM的永久性 7.2 ATL的永久性实现类 7.3 属性映射表 7.4 永久性实现 7.5 其他永久性实现 7.6 使用永久性添加“按值列集”的语义 7.7 总结 第8章 集合和枚举器 8.1 COM集合和枚举接口 8.2 枚举数组 8.3 枚举标准的C++集合 8.4 集合 8.5 ATL数据类型的标准C++集合 8.6 ATL集合 8.7 对象模型 8.8 总结 第9章 连接点 9.1 回顾连接点 9.2 创建基于ATL的可连接对象 9.3 创建一个接收事件的对象 9.4 它是怎么工作的:杂乱的实现细 9.5 总结 第10章 窗口 10.1 Windows应用程序的结构 10.2 CWindow 10.3 CWindowImpl 10.4 CDialogImpl 10.5 Windows控件包装类 10.6 CContainedWindow 10.7 总结 第11章 ActiveX控件 11.1 回顾ActiveX控件 11.2 BullsEye控件需求 11.3 使用ATL向导创建初始的控件 11.4 初始的BullsEye源文件 11.5 逐步开发BullsEye控件 11.6 总结 第12章 控件包容 12.1 控件是如何被包容的 12.2 基本的控件包容 12.3 在对话框中容纳控件 12.4 复合控件 12.5 HTML控件 12.6 ATL控件包容的限制 12.7 总结 第13章 你好,ATL Server:一个新型的C++ Web平台 13.1 微软Web平台(因特网信息服务) 13.2 可能是可以运行的最简单ISAPI扩展 13.3 封装ISAPI 13.4 ATL Server 13.5 ATL Server中的Web服务 13.6 总结 第14章 ATL Server内幕 14.1 ATL Server中的ISAPI实现 14.2 服务器响应文件 14.3 请求处理程序示例 14.4 输入处理 14.5 会话管理 14.6 数据缓存 14.7 总结 附录A 实例展示C++模板 A.1 模板的必要性 A.2 模板基础 A.3 不同类型的多态 A.4 函数模板 A.5 成员函数模板 A.6 总结 附录B ATL头文件 附录C 移植到ATL 8 C.1 字符串、字符集和转换 C.2 与MFC共享的类 C.3 实现COM服务器 C.4 ActiveX控件和控件容纳 C.5 ATL_MIN_CRT变化 C.6 总结 附录D 属性化ATL D.1 ATL Attributes的基础 D.2 属性化ATL的未来 D.3 总结 索引
atl download是指使用Active Template Library(ATL)来实现文件下载操作。ATL是一种微软开发的轻量级C++库,用于简化和加速COM组件的开发。在使用ATL下载文件时,需要通过以下步骤进行深入解析: 1. 创建ATL项目:在Visual Studio中创建一个新的ATL项目。选择空项目模版,并启用ActiveX组件的支持。 2. 定义下载接口:在ATL项目中定义一个下载接口,该接口包含下载文件的方法和属性,如下载文件的URL、保存路径等。 3. 实现下载接口:在ATL项目中实现下载接口。使用ATL提供的HTTP类或者WinINet函数来发送HTTP请求,获取文件内容,并将文件保存到本地计算机。 4. 注册COM组件:使用regsvr32或者Visual Studio中的注册功能,将完成的ATL组件注册到系统中,以便在其他应用程序中使用。 5. 使用ATL下载:在需要下载文件的应用程序中,使用ATL组件的接口来调用下载方法。传入要下载的文件的URL和保存路径,然后执行下载操作。 6. 错误处理与异步下载:在ATL下载中,需要处理可能出现的错误,如网络连接失败或者文件不存在等情况。同时可以使用异步下载方式,可以在下载过程中响应其他操作,提高用户体验。 7. 下载进度显示:通过ATL的进度回调功能,可以实时显示下载进度,并提供用户取消下载的选项。 通过以上步骤,可以深入理解并使用ATL下载文件。注意,ATL download用于Windows平台上的C++开发,适合需要自定义下载逻辑和较高性能要求的应用程序。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值