找回密码
 注册
搜索
查看: 3836|回复: 0

BSTR 字符串

[复制链接]
发表于 2011-5-2 20:06:22 | 显示全部楼层 |阅读模式
原文:http://www.vckbase.com/document/viewdoc/?id=1911! ^2 [- A8 {# G
. t% s" t; Z' n6 _$ A, f" J
BSTR是“Basic String”的简称,微软在COM/OLE中定义的标准字符串数据类型。 ! y% K+ v( f- f- p/ ?
对于VC++,Windows头文件wtypes.h和WinNT.h中定义如下:
- m) |" B9 k+ s& J0 g# c
  1. typedef /* [wire_marshal] */ OLECHAR *BSTR;; u" w. M  Z) p' u! ?
  2. typedef WCHAR OLECHAR;
    $ |4 O, j/ M) F
  3. 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,分别是:
  1. BSTR SysAllocString(const OLECHAR * psz);* A4 s) s. Z3 ^; P$ C
  2. INT  SysReAllocString(BSTR* pbstr,const OLECHAR* psz);
    - X4 K6 A$ m( k  m9 n
  3. BSTR SysAllocStringLen(const OLECHAR * strIn, UINT ui);
    : o7 m# y& N% V+ K
  4. INT  SysReAllocStringLen(BSTR* pbstr,const OLECHAR* psz,unsigned int len);
    . @- g0 N  N) e+ s; d2 |  Q0 y% A: Z
  5. void SysFreeString(BSTR bstrString);7 {* T! v( ?3 u9 R+ }' ~3 Q
  6. UINT SysStringLen(BSTR);
    6 }0 A7 P3 O: n* y: o  B$ S3 M( D
  7. UINT SysStringByteLen(BSTR bstr);
    ; e4 t) ^# \% |: d
  8. BSTR SysAllocStringByteLen(LPCSTR psz,UINT len);
复制代码
下面对上述API用法进行说明。
: d) f! z0 ?+ C7 ^3 L: ^4 x
: p, O- u! J9 [$ f+ ]( P( d7 ~  \1、SysAllocString函数用于创建一个BSTR字符串,如:BSTR bstr=SysAllocString(L"create bstr string");就创建了一个BSTR字符串,上面说过BSTR字符串最初4个字节表示了字符串中字符个数,接下来是字符串中包含的真实字符,下面我们验证一下是否是这样的。我们生成一个WIN32控制台工程,生成时选择支持ATL的头文件,也可以后添加相应的头文件,主要是atlbase.h和atlstr.h,输入如下语句:; g& L  s! }. b$ V

0 q3 ]* e' O! ^( Vprintf("bstr front 4 byte is %x",*((int*)(((int*)bstr-1))));
. n3 p( h* q2 g2 K5 ]- i1 h: ~* Q( i4 h5 u
语句中的bstr是以上刚刚生成的BSTR组符串,此语句显示的结果是“bstr front 4 byte is 24”换算成10进制正好是34,是“create bstr string”长度的2倍因为BSTR字符串中的字符是用Unicode表示的,而语句! X& u9 E4 U" R- S
+ o. Q. `) l- x$ x( H. W
printf("bstr front 0 byte is %c",*((int*)((int*)bstr)));2 V) V4 B& v0 n0 B3 \! _1 t8 d
) D4 c! F' m9 }% K& d; n
输出的是“c”是语句中的第一个字符,语句! C( x( K) i  P

+ f2 U1 k. T7 `. c# |5 D: `4 {0 Pprintf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));
& L( u0 y; u+ G2 k) m  X
" S  ~# A7 P1 q输出的是“g”语句中的最后一个字符,以上说明了SysAllocString函数用法及BSTR字符串在内存中的存储格式。9 L( a, x/ q" d! j
! m: r% e! S. ^* S
2、SysReAllocString用于在一个已有的BSTR字符串的基础上重新建立一个BSTR字符串,输入如下的语句,可以检测该函数使用后的效果:4 D# M( A; [5 t+ k
  1. BSTR bstr=SysAllocString(L"create bstr string");   
    , x8 l- `4 a3 D9 N( X
  2. SysReAllocString (&bstr,L"new string");printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));+ Q( {2 x) Z* Q: A- T4 p
  3. printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));
    8 a! }0 z, N  i$ r4 [1 d
  4. 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所指出的长度范围。但如果新的字符串如果超出原来串的长度,那么原来的字符串将被全部覆盖,长度以新的字符串为准,下面的语句说明了这一点。  
" O3 W7 B( p0 J- x
  1. SysReAllocString (&bstr,L"new string new string");    : }9 k: r7 }  Z0 X5 `2 `
  2. printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));      x' b6 B# y" b+ k; b: S% ~
  3. printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));; ]( e0 p; F' G/ m
  4. printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));
复制代码
3、SysAllocStringLen按照指定的长度分配一个BSTR字符串,例如:- R* T6 n4 u$ X
  1. BSTR bstr=SysAllocStringLen(L"create bstr string",6);   
    / g- d) o+ |* G: v% @* O, [
  2. printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));    8 l+ N. y( I5 t# ^! T
  3. 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串。
9 Q' c" Q3 n' _! n) _0 R5 E7 @" u4、SysReAllocStringLen函数是在已有的字符串的基础上按指定长度重新分配一个新的BSTR字符串。如:
* v+ h) y- D4 {: u. R
  1. BSTR bstr=SysAllocString(L"create bstr string");   
    9 |0 n- q, w3 l/ V3 K7 I- I2 q$ e+ N: w
  2. SysReAllocStringLen(&bstr,L"new string",3);
    9 {! E/ v1 |$ R
  3. printf("bstr front 4 byte is %x\n",*((int*)(((int*)bstr-1))));
    % a& ?0 R4 ?% l$ G, o0 H5 T2 {
  4. printf("bstr front 0 byte is %c\n",*((int*)((int*)bstr)));4 w/ c$ L* B1 n  t1 p
  5. printf("bstr front 35 byte is %c\n",*((char*)(((char*)bstr+34))));
复制代码
5、SysFreeString是释放一个BSTR字符串,BSTR字符串用后必须用此函数进行释放,例如: ' }' g- w( I2 ^$ p
  1. SysFreeString(bstr);
复制代码
6、SysStringLen求一个BSTR字符串的长度,如:
" v/ w. Z9 P$ R2 Z  T+ C$ K
  1. printf("bstr size is %d\n",SysStringLen(bstr));其长度是指字符串中字符个数,而非字节数。
复制代码
7、SysStringByteLen求一个BSTR字符串的字节长度,如:
3 t# E7 o9 D2 @& `2 d+ D  ?
  1. printf("bstr size is %d\n",SysStringByteLen(bstr));
复制代码
8、SysAllocStringByteLen是按字节长度分配一个BSTR字符串。' z& v* d) E, R
以上大致就是BSTR API 的用法,为了方便操作BSTR字符串,在ATL中建立了CComBSTR类专门用于操作BSTR字符,下面大致说说该类的用法。
0 `- \2 @, o4 E5 `CComBSTR类维护了公有的BSTR类型成员变量m_str,定义了8个构造函数用于创建CComBSTR对象,在析构函数中释放了m_str,在类中定义了常用的操作符并提供了对象持久性支持。
( M  a7 }5 y2 O9 o1、构造一个CComBSTR对象
2 U5 ^( I2 Z; j: V) N- E5 y$ K/ q
  J# B5 `! j1 s/ X; i- S1 W
  1. CComBSTR bstr1;
    8 A7 ~) F; B% F6 @$ c$ {
  2. MessageBox(NULL,bstr1.m_str ,L"bstr test",MB_OK); 创建一个空的CComBSTR 对象
    . l: G% A$ U1 a, j) \( G
  3. * e: s' _- g, ], R1 M6 o5 r
  4. CComBSTR bstr2(L"this is a BSTR string");
    ! W& N  |5 b* O1 w
  5. MessageBox(NULL,bstr2.m_str ,L"bstr test",MB_OK); 创建一个包含"this is a BSTR string"字符串的CComBSTR 对象
    0 X" a& B/ \% z. v; P" O5 ~2 @
  6. ) {: w$ r. Z0 @# ]" }3 H
  7. CComBSTR bstr3(5);
    - Z1 B" _9 ^2 n& N& z
  8. MessageBox(NULL,bstr3.m_str ,L"bstr test",MB_OK);创建一个初始长度为5,含NULL的CComBSTR对象。! c; b6 E& ~1 l1 m! O5 `/ x, I

  9. 3 }- l, j7 i" \1 H4 a
  10. CComBSTR bstr4(3,L"this is a BSTR string");! K" _  E- R" Q6 \- e5 b; \  ?
  11. MessageBox(NULL,bstr4.m_str ,L"bstr test",MB_OK);创建一个长度为3的CComBSTR对象,后面的字符串舍去。
复制代码
我们也可以从一个已经存在的CComBSTR对象创建另一个CCOmBSTR对象,如:
) a  a$ q" ]5 F
  1. CComBSTR bstr1(L"this is a BSTR string");
    5 e1 p9 o! @4 N( G* s
  2. CComBSTR bstr2(bstr1);+ X& [! \' c4 }" ^& P3 I; Q* A6 }
  3. MessageBox(NULL,bstr2.m_str ,L"bstr test",MB_OK);
复制代码
最后的一个构造函数比较奇怪,他接受一个GUID参数,生成一个包含GUID字符串的CComBSTR对象,如: 3 D7 h' l* v8 ]
  1. static const GUID GUID_Sample={0X8a44e110,0xf134,0x11d1,{0x96,0xb1,0xba,0xdb,0xba,0xdb,0xad,0xcc}};
    3 M* l, x- x% d6 ]
  2. CComBSTR bstr1(GUID_Sample);) ~1 ~; I6 ~# h  t! i8 n
  3. MessageBox(NULL,bstr1.m_str ,L"bstr test",MB_OK);
复制代码
2、CComBSTR定义的常用操作如下
+ h5 I; M, H4 ~" l9 D; @9 I(1)“=”操作符(赋值操作),如:: W; ]( Q+ g( R- C# G3 v8 N
  1. CComBSTR bstr1(L"this is a BSTR string");
    " g( v: h0 C8 w* _; W2 u
  2. CComBSTR bstr2=bstr1;6 O3 k6 I2 H5 E3 Y! {; j& E
  3. MessageBox(NULL,bstr2.m_str ,L"BSTR test",MB_OK);bstr2和bstr1包含相同内容。
复制代码
(2)BSTR操作符把CComBSTR对象显式的或隐式的转换成BSTR字符串,如:
3 f$ ?- w4 }) Q" s8 n1 C; X
  1. CComBSTR bstr1(L"this is a BSTR string");) m2 U; s! \9 F0 N  |) ^
  2. BSTR bstr2=bstr1;+ O* N3 e6 _& S  D% Y
  3. MessageBox(NULL,bstr2 ,L"BSTR test",MB_OK);隐式转换- K8 v& V% _9 I; C- e  h' P+ R- V- S
  4. * \! P7 ~. d$ s  A  w$ p7 c0 n
  5. CComBSTR bstr1(L"this is a BSTR string");2 p* `1 i/ b2 }6 d4 ~
  6. MessageBox(NULL,(BSTR)bstr1 ,L"BSTR test",MB_OK);显式转换
复制代码
(3)!= 操作符,用来直接比较两个CComBSTR对象,如:
+ n  {# Z4 l$ t8 C: [! G6 |" J: T
  1. CComBSTR bstr1(L"this is a BSTR string1");: w+ v1 [6 R4 r, }* u* C
  2. CComBSTR bstr2(L"this is a BSTR string2");
    6 S3 T1 b$ B/ M8 O; H
  3. if (bstr1!=bstr2){# l& h9 ^9 m  M# o! Y$ @9 v2 P. H
  4.         MessageBox(NULL,L"true",L"BSTR test",MB_OK);
    ' S$ B) c6 J' b
  5. }
    3 X2 c# k* O* ^8 v0 X
  6. else1 I* J3 h; @0 }  n
  7. {: ~- k  ]0 J( C  d+ W+ M  Z6 n
  8.         MessageBox(NULL,L"false",L"BSTR
    ! b& I6 `  h  Q. Q& |/ H2 C: k, x
  9. test",MB_OK);$ X$ j8 M; I' u  H- X6 _9 ]
  10. }
复制代码
3、CComBSTR定义的常用方法如下
9 o: ?: y$ M/ [% N- L6 g: u(1)Copy 方法,该方法拷贝CComBSTR对象中的BSTR字符串并返回BSTR字符串,如:1 m' y' H: _/ \- }
  1. CComBSTR bstr1(L"this is a BSTR string1");1 I8 Y+ R1 H0 X# J$ q" H) @
  2. BSTR bstr2=bstr1.Copy ();+ l7 y  C: }" O% }( H/ P6 [$ `( l
  3. MessageBox(NULL,bstr2,L"BSTR test",MB_OK);
复制代码
(2)CopyTo 方法将CComBSTR对象中的BSTR字符串拷贝到新的位置,必须显式的调用SysStringFree来释放返回的字符串,如:
6 _9 k1 o+ O- v) a4 a* j
  1. CComBSTR bstr1(L"this is a BSTR string1");( ^. X* G( e7 }
  2. BSTR bstr2;
    ) o+ J+ K" @& c: y- k# j5 F  C* B
  3. bstr1.CopyTo(&bstr2);
    9 D& V- K  Q6 G5 {
  4. MessageBox(NULL,bstr2,L"BSTR test",MB_OK);
复制代码
(3)Attach方法把一个BSTR字符串附加到CComBSTR对象上,如:
5 C. M4 S% \* m$ f: ~. E: d
  1. BSTR bstr1=::SysAllocString (L"this is a BSTR string");; w0 b2 y2 |  A1 j
  2. CComBSTR bstr2;! T- f9 r1 X* D7 |! B+ G
  3. bstr2.Attach(bstr1);
    5 Q; f3 p) U" C- C8 `
  4. MessageBox(NULL,bstr2.m_str ,L"BSTR test",MB_OK);
复制代码
(4)Detach方法分离BSTR字串与CComBSTR对象,用法:
! @0 H; S  ~; [9 [
  1. bstr2.Detach ();
复制代码
(5)Empty 方法,释放对象中的BSTR字符串。 CComBSTR对象还有一些其它的方法,如附加字符串、大小写转换、对象持久性等并不常用。总之BSTR字符串是COM技术的基石,CComBSTR是处理BSTR字符串的利器,深入理解BSTR字符串是研究COM技术必须经过的关口。
5 X+ x6 A3 S0 p
1 A! V" U/ I) z& ?
您需要登录后才可以回帖 登录 | 注册

本版积分规则

Archiver|手机版|小黑屋|宁德市腾云网络科技有限公司 ( 闽ICP备2022007940号-5|闽公网安备 35092202000206号 )

GMT+8, 2026-6-18 10:43 , Processed in 0.018318 second(s), 14 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表