登录  
 加关注
查看详情
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

梦想之鹰的天空

天高任鸟飞......放飞....心情..........放飞.....梦想

 
 
 

日志

 
 

BSTR 字符串  

2011-06-24 16:32:16|  分类: 程序设计 |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |

BSTR是“Basic String”的简称,微软在COM/OLE中定义的标准字符串数据类型。
对于VC++,Windows头文件wtypes.h和WinNT.h中定义如下:

typedef /* [wire_marshal] */ OLECHAR *BSTR;  typedef WCHAR OLECHAR;  typedef wchar_t WCHAR;  
由于COM是跨系统及不同开发语言间实现互操作的技术,常规以Null结尾的简单字符串在COM 组件间传递不太方便。因此,便出现了BSTR字符串类型,BSTR是指针类型,标准BSTR是一个有长度前缀和null结束符的OLECHAR数组。BSTR的前4字节是一个表示字符串长度的前缀。BSTR长度域的值是字符串的字节数,但不包括字符串结束符。 BSTR实际上包含的是Unicode串,所以字符数是字节数的一半。这种方式的优点是允许程序员在BSTR串中间嵌入NULL字符,字符串的长度由BSTR的前四个字节表示,(长度中可能包含NULL),bstr字符串是不能象基本数据类型一样直接进行定义的。为处理BSTR字符串,微软在OleAuto.h中定义了BSTR API,分别是:
BSTR SysAllocString(const OLECHAR * psz);  INT  SysReAllocString(BSTR* pbstr,const OLECHAR* psz);  BSTR SysAllocStringLen(const OLECHAR * strIn, UINT ui);  INT  SysReAllocStringLen(BSTR* pbstr,const OLECHAR* psz,unsigned int len);  void SysFreeString(BSTR bstrString);  UINT SysStringLen(BSTR);  UINT SysStringByteLen(BSTR bstr);  BSTR SysAllocStringByteLen(LPCSTR psz,UINT len);  
下面对上述API用法进行说明。

1、SysAllocString函数用于创建一个BSTR字符串,如:BSTR bstr=SysAllocString(L"create bstr string");就创建了一个BSTR字符串,上面说过BSTR字符串最初4个字节表示了字符串中字符个数,接下来是字符串中包含的真实字符,下面我们验证一下是否是这样的。我们生成一个WIN32控制台工程,生成时选择支持ATL的头文件,也可以后添加相应的头文件,主要是atlbase.h和atlstr.h,输入如下语句:

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

语句中的bstr是以上刚刚生成的BSTR组符串,此语句显示的结果是“bstr front 4 byte is 24”换算成10进制正好是34,是“create bstr string”长度的2倍因为BSTR字符串中的字符是用Unicode表示的,而语句

printf("bstr front 0 byte is %c",*((int*)((int*)bstr)));

输出的是“c”是语句中的第一个字符,语句

printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));

输出的是“g”语句中的最后一个字符,以上说明了SysAllocString函数用法及BSTR字符串在内存中的存储格式。

2、SysReAllocString用于在一个已有的BSTR字符串的基础上重新建立一个BSTR字符串,输入如下的语句,可以检测该函数使用后的效果:

BSTR bstr=SysAllocString(L"create bstr string");      SysReAllocString (&bstr,L"new string");      printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));      printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));  printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));  
该语句最后输出是“14,n,g”说明SysReAllocString (&bstr,L"new string");语句是在已经生成的bstr字符串上建立一个新的字符串,因新串“new string”的长度是20,换算成16进制正好是14,而输出的g说明因新串短于旧串所以原字符串超出的部分为变化,但已经超出14所指出的长度范围。但如果新的字符串如果超出原来串的长度,那么原来的字符串将被全部覆盖,长度以新的字符串为准,下面的语句说明了这一点。
 SysReAllocString (&bstr,L"new string new string");      printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));      printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));  printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));  
3、SysAllocStringLen按照指定的长度分配一个BSTR字符串,例如:
BSTR bstr=SysAllocStringLen(L"create bstr string",6);      printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));      printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));  printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));  
虽然“create bstr string”的长度是18个字符但此语句只分派6个字符的BSTR串。
4、SysReAllocStringLen函数是在已有的字符串的基础上按指定长度重新分配一个新的BSTR字符串。如:
BSTR bstr=SysAllocString(L"create bstr string");      SysReAllocStringLen(&bstr,L"new string",3);      printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));      printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));  printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));  
5、SysFreeString是释放一个BSTR字符串,BSTR字符串用后必须用此函数进行释放,例如:
SysFreeString(bstr);
6、SysStringLen求一个BSTR字符串的长度,如:
printf("bstr size is %d\n",SysStringLen(bstr));其长度是指字符串中字符个数,而非字节数。
7、SysStringByteLen求一个BSTR字符串的字节长度,如:
printf("bstr size is %d\n",SysStringByteLen(bstr));
8、SysAllocStringByteLen是按字节长度分配一个BSTR字符串。
以上大致就是BSTR API 的用法,为了方便操作BSTR字符串,在ATL中建立了CComBSTR类专门用于操作BSTR字符,下面大致说说该类的用法。
CComBSTR类维护了公有的BSTR类型成员变量m_str,定义了8个构造函数用于创建CComBSTR对象,在析构函数中释放了m_str,在类中定义了常用的操作符并提供了对象持久性支持。
1、构造一个CComBSTR对象
CComBSTR bstr1;  MessageBox(NULL,bstr1.m_str ,L"bstr test",MB_OK); 创建一个空的CComBSTR 对象    CComBSTR bstr2(L"this is a BSTR string");  MessageBox(NULL,bstr2.m_str ,L"bstr test",MB_OK); 创建一个包含"this is a BSTR string"字符串的CComBSTR 对象    CComBSTR bstr3(5);  MessageBox(NULL,bstr3.m_str ,L"bstr test",MB_OK);创建一个初始长度为5,含NULL的CComBSTR对象。    CComBSTR bstr4(3,L"this is a BSTR string");  MessageBox(NULL,bstr4.m_str ,L"bstr test",MB_OK);创建一个长度为3的CComBSTR对象,后面的字符串舍去。  
我们也可以从一个已经存在的CComBSTR对象创建另一个CCOmBSTR对象,如:
CComBSTR bstr1(L"this is a BSTR string");      CComBSTR bstr2(bstr1);  MessageBox(NULL,bstr2.m_str ,L"bstr test",MB_OK);  
最后的一个构造函数比较奇怪,他接受一个GUID参数,生成一个包含GUID字符串的CComBSTR对象,如:
static const GUID GUID_Sample={0X8a44e110,0xf134,0x11d1,{0x96,0xb1,0xba,0xdb,0xba,0xdb,0xad,0xcc}};      CComBSTR bstr1(GUID_Sample);  MessageBox(NULL,bstr1.m_str ,L"bstr test",MB_OK);  
2、CComBSTR定义的常用操作如下
(1)“=”操作符(赋值操作),如:
CComBSTR bstr1(L"this is a BSTR string");      CComBSTR bstr2=bstr1;  MessageBox(NULL,bstr2.m_str ,L"BSTR test",MB_OK);bstr2和bstr1包含相同内容。  
(2)BSTR操作符把CComBSTR对象显式的或隐式的转换成BSTR字符串,如:
CComBSTR bstr1(L"this is a BSTR string");  BSTR bstr2=bstr1;  MessageBox(NULL,bstr2 ,L"BSTR test",MB_OK);隐式转换    CComBSTR bstr1(L"this is a BSTR string");  MessageBox(NULL,(BSTR)bstr1 ,L"BSTR test",MB_OK);显式转换  
(3)!= 操作符,用来直接比较两个CComBSTR对象,如:
CComBSTR bstr1(L"this is a BSTR string1");      CComBSTR bstr2(L"this is a BSTR string2");      if (bstr1!=bstr2)      {          MessageBox(NULL,L"true",L"BSTR test",MB_OK);      }      else       {          MessageBox(NULL,L"false",L"BSTR test",MB_OK);  }  
3、CComBSTR定义的常用方法如下
(1)Copy 方法,该方法拷贝CComBSTR对象中的BSTR字符串并返回BSTR字符串,如:
CComBSTR bstr1(L"this is a BSTR string1");      BSTR bstr2=bstr1.Copy ();  MessageBox(NULL,bstr2,L"BSTR test",MB_OK);  
(2)CopyTo 方法将CComBSTR对象中的BSTR字符串拷贝到新的位置,必须显式的调用SysStringFree来释放返回的字符串,如:
CComBSTR bstr1(L"this is a BSTR string1");      BSTR bstr2;      bstr1.CopyTo (&bstr2);  MessageBox(NULL,bstr2,L"BSTR test",MB_OK);
(3)Attach方法把一个BSTR字符串附加到CComBSTR对象上,如:
BSTR bstr1=::SysAllocString (L"this is a BSTR string");      CComBSTR bstr2;      bstr2.Attach (bstr1);  MessageBox(NULL,bstr2.m_str ,L"BSTR test",MB_OK);  
(4)Detach方法分离BSTR字串与CComBSTR对象,用法:
bstr2.Detach ();
(5)Empty 方法,释放对象中的BSTR字符串。 CComBSTR对象还有一些其它的方法,如附加字符串、大小写转换、对象持久性等并不常用。总之BSTR字符串是COM技术的基石,CComBSTR是处理BSTR字符串的利器,深入理解BSTR字符串是研究COM技术必须经过的关口。
  评论这张
 
阅读(444)| 评论(0)

历史上的今天

评论

<#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
 
 
 
 
 
 
 
 
 
 
 
 
 
 

页脚

网易公司版权所有 ©1997-2018