关闭

BSTR/CComBSTR字符串的结构和用法

标签: BSTRCComBSTR
1484人阅读 评论(0) 收藏 举报
分类:

参考文档:http://www.vckbase.com/index.php/wv/1604 (注:本文的大部分内容都是从该文章中获取)

 

BSTR字符串是COM技术的基石,CComBSTR是处理BSTR字符串的利器,深入理解BSTR字符串是研究COM技术必须经过的关口。

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

typedefwchar_tWCHAR;

typedefWCHAROLECHAR;

typedef  OLECHAR *BSTR;

相当于 typedef   wchar_t  *BSTR;    从存储结构上可以看出BSTR为wchar_t 的字符串

 

BSTR的存储结构为:

1. 字符串头      ---4字节  存储了包好字节(Byte)的个数

2. 字符串内容 ---以unicode方式存储,每个字符两字节(w_char - 2byte)

3. 结束符          ---结束符null, 2字节

使用下面语句可以查询出字符串头,从而获取BSTR存储内容的字节数

printf("bstr front 4 byte is %x",*((int*)(((int*)bstr-1))));

 

为处理BSTR字符串,微软在OleAuto.h中定义了BSTR API,分别是:

BSTR SysAllocString(const OLECHAR * psz);                                 // 使用w_char串创建一个BSTR字符串
INT  SysReAllocString(BSTR* pbstr,const OLECHAR* psz);                    // 重置BSTR里的内容
BSTR SysAllocStringLen(const OLECHAR * strIn, UINT ui);                   // 创建一个指定长度的BSTR串
INT  SysReAllocStringLen(BSTR* pbstr,const OLECHAR* psz,unsigned int len);// 重置BSTR里的内容
void SysFreeString(BSTR bstrString);                                      // 释放BSTR 
UINT SysStringLen(BSTR);                                                  // 获取字符串长度
UINT SysStringByteLen(BSTR bstr);                                         // 获取字符串字节长度
BSTR SysAllocStringByteLen(LPCSTR psz,UINT len);                          // 创建BSTR串


 

下面对上述API用法进行说明。

1、SysAllocString函数用于创建一个BSTR字符串,如:BSTR bstr=SysAllocString(L"create bstr string");就创建了一个BSTR字符串

2、SysReAllocString用于在一个已有的BSTR字符串的基础上重新建立一个BSTR字符串

3、SysAllocStringLen按照指定的长度分配一个BSTR字符串,例如:
    BSTR bstr=SysAllocStringLen(L"create bstr string",6);
虽然“create bstr string”的长度是18个字符但此语句只分派6个字符的BSTR串。

4、SysReAllocStringLen函数是在已有的字符串的基础上按指定长度重新分配一个新的BSTR字符串。

5、SysFreeString是释放一个BSTR字符串,BSTR字符串用后必须用此函数进行释放
6、SysStringLen求一个BSTR字符串的长度,其长度是指字符串中字符个数,而非字节数。

7、SysStringByteLen求一个BSTR字符串的字节长度

8、SysAllocStringByteLen是按字节长度分配一个BSTR字符串。

 

以上大致就是BSTR API 的用法,为了方便操作BSTR字符串,在ATL中建立了CComBSTR类专门用于操作BSTR字符,下面大致说说该类的用法。

CComBSTR类维护了公有的BSTR类型成员变量m_str,定义了8个构造函数用于创建CComBSTR对象,在析构函数中释放了m_str,在类中定义了常用的操作符并提供了对象持久性支持。

1、构造一个CComBSTR对象

CComBSTR bstr1;  创建一个空的CComBSTR 对象,内容为空""

CComBSTR bstr2(L"this is a BSTR string"); 创建一个包含"this is a BSTR string"字符串的CComBSTR对象

CComBSTR bstr3(5); 创建一个初始长度为5,内容为"     "的CComBSTR对象。

CComBSTR bstr4(3,L"this is a BSTR string"); 创建一个长度为3的CComBSTR对象,内容为"thi"

ComBSTR bstr2(bstr1); 通过bstr1构造bstr2

static const GUID GUID_Sample={0X8a44e110,0xf134,0x11d1,{0x96,0xb1,0xba,0xdb,0xba,0xdb,0xad,0xcc}}; 

CComBSTR bstr1(GUID_Sample);  通过GUID构造

2、CComBSTR定义的常用操作如下

(1)“=”操作符(赋值操作)

(2)BSTR操作符把CComBSTR对象显式的或隐式的转换成BSTR字符串

(3)!= 操作符,用来直接比较两个CComBSTR对象

3、CComBSTR定义的常用方法如下

 (1)Copy 方法,该方法拷贝CComBSTR对象中的BSTR字符串并返回BSTR字符串

(2)CopyTo 方法将CComBSTR对象中的BSTR字符串拷贝到新的位置

(3)Attach方法把一个BSTR字符串附加到CComBSTR对象上

(4)Detach方法分离BSTR字串与CComBSTR对象

(5)Empty 方法,释放对象中的BSTR字符串


  

Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu  转载请标明来源 

 

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:251562次
    • 积分:4197
    • 等级:
    • 排名:第8263名
    • 原创:183篇
    • 转载:45篇
    • 译文:1篇
    • 评论:27条
    文章分类
    最新评论