BSTR字符串类型(跨编程语言的字符串)

计算机 C++ 字符串

概述

它被描述成一个与自动化相兼容的类型，由于 操作系统提供相应的API函数(如SysAllocString)来管理它以及一些默认的调度代码。因此BSTR实际上就是一个COM字符串，但它却在自动化技术以外的多种场合下得到广泛使用。

为什么需要BSTR

COM是一种跨 编程语言的平台，需要提供语言无关的 数据类型。多数 编程语言有自己的字符串表示。

●C++  字符串是以0结束的ASCII或Unicode字符 数组。

●Visual Basic 字符串是一个ASCII字符 数组加上表示长度的前缀。

●Java字符串是以0结束的Unicode字符 数组。

需要定义一种通用的字符串类型，可以很容易的匹配到不同 编程语言。 在C++中，就是BSTR。

什么是BSTR

BSTR是“Basic STRing”的简称， 微软在COM/OLE中定义的标准字符串 数据类型。

对于C++，Windows头文件wtypes.h中定义如下：

1 2 3

typedef wchar_t WCHAR ; typedef WCHAR OLECHAR; typedef OLECHAR __RPC_FAR *BSTR;;

使用以Null结尾的简单字符串在COM component间传递不太方便。因此， 标准BSTR是一个有长度前缀和null结束符的OLECHAR数组。BSTR的前4 字节是一个表示字符串长度的前缀。BSTR长度域的值是字符串的字节数，并且不包括0结束符。

由于是Unicode串，所以 字符数是字节数的一半。这种方式的优点是允许程序员在BSTR串中间嵌入NULL 字符。但是，BSTR的前四个 字节表示长度，而OLECHAR数组的前四字节表示前两个字符。这种情况下，对于C++程序，如何实现BSTR和OLECHAR的交换？答案是COM提供了两个BSTR分配用的API：SysAllocString / SysReallocString。函数返回的 指针指向BSTR的第一个 字符，而不是BSTR在内存的第一个 字节。

什么时候使用BSTR

只有在你不得不用的时候。

使用BSTR一般有以下几种情况：

●COM interface接口定义，并且不希望额外提供custom marshaling库（MDIL生成或开发人员自己订制），必须使用BSTR传递字符串。使用C/C++类型的字符串在COM DLL传递字符串，表面上可以使用，但违背了COM的基本规则，并且给以后的扩展留下了隐患。例如，把一个In-process COM Object(简单说COM DLL)改成out-of-process object（COM EXE）。理论上， 客户端的代码应该不做任何改变。但如果是用了C/C++字符串，又希望只使用系统的automation mashaller（Oleaut32.dll），就会出错。

●如果可以提供custom marshaling，也推荐使用BSTR。

●客户要求接口必须使用BSTR，和客户讨论后，不能修改。

●使用的外部库的接口使用BSTR

不使用的情况：

● 不推荐在IDL结构体中定义BSTR成员，会给结构体的复制和释放带来麻烦。最好直接使用限定最大长度的TCHAR数组。如果确实需要传递变长字符串，BSTR应该被定义成独立的参数或者使用独立的get/set接口。

● 尽可能缩小的BSTR及相关类型的作用域范围。类的 成员变量和函数参数不使用BSTR。 局部变量要尽快释放类的内部不使用BSTR。代码处理逻辑中只在接口直接相关部分使用BSTR。接收到一个BSTR时，尽量立刻变成C/C++的字符串副本进行处理。在需要传递BSTR参数前产生BSTR，用过立即释放。

转换：

(3) BSTR转换成char*

　　方法一，使用ConvertBSTRToString。例如：

[cpp]  view plain copy

1. #include   
2. #pragma comment(lib, "comsupp.lib")  
3. int _tmain(int argc, _TCHAR* argv[]){  
4. BSTR bstrText = ::SysAllocString(L"Test");  
5. char* lpszText2 = _com_util::ConvertBSTRToString(bstrText);  
6. SysFreeString(bstrText); // 用完释放  
7. delete[] lpszText2;  
8. return 0;  
9. }   

 

　　方法二，使用_bstr_t的赋值运算符重载。例如：

[cpp]  view plain copy

1. _bstr_t b = bstrText;  
2. char* lpszText2 = b;   

 

(4) char*转换成BSTR

　　方法一，使用SysAllocString等API函数。例如：

[cpp]  view plain copy

1. BSTR bstrText = ::SysAllocString(L"Test");  
2. BSTR bstrText = ::SysAllocStringLen(L"Test",4);  
3. BSTR bstrText = ::SysAllocStringByteLen("Test",4);   

 

　　方法二，使用COleVariant或_variant_t。例如：

[cpp]  view plain copy

1. //COleVariant strVar("This is a test");  
2. _variant_t strVar("This is a test");  
3. BSTR bstrText = strVar.bstrVal;   

 

　　方法三，使用_bstr_t，这是一种最简单的方法。例如：

[cpp]  view plain copy

1. BSTR bstrText = _bstr_t("This is a test");   

 

　　方法四，使用CComBSTR。例如：

[cpp]  view plain copy

1. BSTR bstrText = CComBSTR("This is a test");   

　　或

[cpp]  view plain copy

1. CComBSTR bstr("This is a test");  
2. BSTR bstrText = bstr.m_str;   

 

　　方法五，使用ConvertStringToBSTR。例如：

[cpp]  view plain copy

1. char* lpszText = "Test";  
2. BSTR bstrText = _com_util::ConvertStringToBSTR(lpszText);   

 

(5) CString转换成BSTR

　　通常是通过使用CStringT::AllocSysString来实现。例如：

[cpp]  view plain copy

1. CString str("This is a test");  
2. BSTR bstrText = str.AllocSysString();  
3. …  
4. SysFreeString(bstrText); // 用完释放  

 

(6) BSTR转换成CString

　　一般可按下列方法进行：

[cpp]  view plain copy

1. BSTR bstrText = ::SysAllocString(L"Test");  
2. CStringA str;  
3. str.Empty();  
4. str = bstrText;   

　　或

[cpp]  view plain copy

1. CStringA str(bstrText);