From | To | Sample |
字符串常量 | BSTR |
Right: BSTR bs = ::SysAllocString(_T("Test string")); … ::SysFreeString(); Wrong: BSTR bs = _T("Test string"); //ERROR |
LPWSTR / LPCWSTR / WCHAR* / wchar_t |
BSTR |
Right: LPCTSTR sz1 = _T("Test String"); BSTR bs = ::SysAllocString(sz1); … ::SysFreeString();
Wrong: LPTSTR sz1 = _T("Test String"); BSTR bs = sz1; //ERROR |
BSTR |
LPCWSTR / const WCHAR * / const wchar_t * |
Right: BSTR bs = ...; // ... LPCTSTR sz = static_cast<LPCTSTR>bs; ... ::SysFreeString(bs); //Never use sz after this line
Wrong: BSTR bs = ...; // ...
LPCTSTR sz = bs; ... ::SysFreeString(bs); //Never use sz after this line _tcslen(sz); //ERROR
|
BSTR |
LPWSTR / WCHAR* / wchar_t* |
Right: BSTR bs = ...; // //... UINT len = ::SysStringLen(bs);
// Do not modify the BSTR content by // C/C++ string functions LPTSTR sz = new TCHAR[len+1]; _tcsncpy(sz, bs, len); ::SysFreeString(bs);
delete []sz; Wrong: BSTR bs = ...; // //...
// Do not modify the BSTR content by // C/C++ string functions LPTSTR sz = bs; //Error
|
CString | BSTR |
Right:
CString str1 = ...;
BSTR bs = str1.AllocSysString(); SomeMethod(bs); // void SomeMethod([in]BSTR) ::SysFreeString(bs);
CComBSTR bs1(static_cast<LPCTSTR>(str1)); SomeMethod(static_cast<BSTR> (bs1) );
// void SomeMethod([in] BSTR ) _bstr_t bs2( static_cast<LPCTSTR>(str1)); SomeMethod(static_cast<BSTR> (bs2) );
Wrong: CString str1 = ...;
SomeMethod(str1.AllocSysString());
// No one will releasee the return BSTR of // str1.AllocSysString()
|
BSTR | CString |
Right:
BSTR bs = SysAllocString(_T(“Test”)); CString str1(bs); CString str2; Str2 = bs; SysFreeString(bs); // Never forget this line |
char* / LPSTR / LPCSTR | BSTR |
Right: Solution 1: char str[MAX_STR_LEN] = "ANSI string"; WCHAR wstr[MAX_WSTR_LEN]; // Convert ANSI to Unicode
MultiByteToWideChar( CP_ACP, 0, str, strlen(str)+1, wstr, sizeof(wstr)/sizeof(wstr[0]) );
BSTR bs1 = ::SysAllocString(wstr);
CString cs = str; BSTR bs2 = cs.AllocSysString()
Solution 2: char str[MAX_STR_LEN] = "ANSI string"; _bstr_t bs1(str); CComBSTR bs2(str);
Wrong: char *str = "ANSI string"; BSTR bstr1 = SysAllocString( (const OLECHAR*) str); |
BSTR | char* / LPSTR / LPCSTR |
Right: Solution 1: char str[MAX_STR_LEN]; BSTR bs = ::SysAllocString(L"Test"); // Convert ANSI to Unicode WideCharToMultiByte( CP_ACP, 0, (LPCWSTR)bs, -1, str, MAX_STR_LEN, NULL, NULL ); ::SysFreeString(bs);
Solution 2: BSTR bs = ::SysAllocString(L"Test"); _bstr_t bs1(bs, false); const char* str = static_cast <const char*> bs1;
Wrong: BSTR bstr1 = SysAllocString(L”ANSI string"); char *str = (char*) bstr1; |
BSTR是一种字符串指针,如果你在VC找寻其定义,你会发现它其实是unsigned short*,然而它不能像普通的字符串指针char*一样可以直接赋值,而必须使用SysAllocString来分配,用SysFreeString来释放。
另外,又有两个BSTR的包容类_bstr_t和CComBSTR,它们是为了编程者使用BSTR更加方便,因为在他们的构造函数中都调用了SysAllocString,析构函数调用了SysFreeString,然而使用这两个类时仍然需要特别注意,否则也会导致不可预知的错误。
举例如下:
1.标准用法:
需要注意的是当SysFreeString被调用后,最好将此BSTR变量赋为NULL,以防止多次释放,导致释放非法内存空间。
2._bstr_t类型有一个函数叫copy,使用时需要当心,因为它其实调用了SysAllocStringByteLen,所以需要调用者去释放返回的BSTR字符串。
用法如下:
3._bstr_t类型有一个特殊构造函数,其第二个参数是一个bool值,表示是否进行SysAllocString,如果是false,表示直接将此字符指针赋给_bstr_t内部所包容的BSTR,这虽然给使用者带来了更大的灵活性,但却需要使用时更加注意,用法如下:
注意,此时不需要调用SysFreeString,因为_bstr_t的构造函数虽然没有调用SysAllocString,但其析构函数仍然会调用SysFreeString。所以不需要使用者自己去释放了。
4.函数接口传递BSTR或BSTR*的基本规则
· 如果调用一个使用BSTR参数的函数,调用者负责在调用前分配BSTR,在调用后释放。例如:
· 如果你调用一个返回BSTR函数的函数,你应该负责释放返回的BSTR。例如:
· 如果你实现一个返回BSTR的函数,在函数内部分配内存但不要释放。调用者负责释放。例如:
· 时刻牢记BSTR是一个指针,而不是一个对象。尽量减少使用BSTR作为结构体或类的成员变量。如果必须使用,一定要认真考虑如何分配和释放。
5.下面介绍一种比较复杂的情况,利于对问题的深入理解。例如我们现在用到的ICF底层库就有很多类似下面的函数:
其中_bstr_t的copy函数其实调用了SysAllocStringByteLen,所以需要此函数的调用者去进行释放。
释放时需要特别注意,像如下这两种调用方法都是正确的:
(1)
(2)
在第一种情况中,CComBSTR被强制转换为BSTR后接受了m_state.copy()返回的字符指针,同时SysAllocStringByteLen被调用了一次,而当其被析构时,SysFreeString被自动调用。所以这种调用方法最终保证了BSTR字符串的正确分配与释放。
在第二中情况中,变量str1接受了m_state.copy()返回的字符指针,同时SysAllocStringByteLen被调用了一次,而在_bstr_t类型变量str2的构造函数中,第二个参数为false,这表示构造函数不再调用SysAllocString,而当其被析构时,SysFreeString被自动调用。所以这种调用方法也是正确的。
而当一个类有一个CComBSTR类型的成员变量时,下面这种调用是错误的:
(3)
因为,它可能被调用多次,每次都执行了SysAllocStringByteLen,但成员变量只会析构一次,所以这样做的问题是会导致内存泄漏,正确的使用方法如下:
(4)
这样使用之所以正确,是因为CComBSTR被赋值时,会调用SysFreeString将其原来的字串释放,并调用SysAllocString,为其分配新的字串。
调用Com接口方法,输入参数中有BSTR参数时的调用方法。
调用Com接口方法,输出参数中有BSTR参数时的调用方法。
函数的参数中有BSTR和BSTR*
(End)