[精华] VC中BSTR、Char和CString类型的转换

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.标准用法:

BSTR str = SysAllocString(L"aaa");
…(可以使用此BSTR变量的范围)
SysFreeString(str);
str = NULL;

需要注意的是当SysFreeString被调用后,最好将此BSTR变量赋为NULL,以防止多次释放,导致释放非法内存空间。

2._bstr_t类型有一个函数叫copy,使用时需要当心,因为它其实调用了SysAllocStringByteLen,所以需要调用者去释放返回的BSTR字符串。

用法如下:

_bstr_t m_state = L"cc";
       BSTR str = m_state.copy();
   …(可以使用此BSTR变量的范围)
SysFreeString(str);
str = NULL;

3._bstr_t类型有一个特殊构造函数,其第二个参数是一个bool值,表示是否进行SysAllocString,如果是false,表示直接将此字符指针赋给_bstr_t内部所包容的BSTR,这虽然给使用者带来了更大的灵活性,但却需要使用时更加注意,用法如下:

BSTR str1 = SysAllocString(L”aaa”);
_bstr_t str2(str1, false);

注意,此时不需要调用SysFreeString,因为_bstr_t的构造函数虽然没有调用SysAllocString,但其析构函数仍然会调用SysFreeString。所以不需要使用者自己去释放了。

 

4.函数接口传递BSTR或BSTR*的基本规则

·  如果调用一个使用BSTR参数的函数,调用者负责在调用前分配BSTR,在调用后释放。例如:

HRESULT IWebBrowser2::put_StatusText( BSTR bstr );  
// shows using the Win32 function  
// to allocate memory for the string:  
BSTR bstrStatus = ::SysAllocString( L"Some text" );  
if (bstrStatus == NULL)  
   return E_OUTOFMEMORY;  
   
pBrowser->put_StatusText( bstrStatus );  
// Free the string:  
::SysFreeString( bstrStatus );  
//...

·  如果你调用一个返回BSTR函数的函数,你应该负责释放返回的BSTR。例如:

HRESULT IWebBrowser2::get_StatusText( BSTR FAR* pbstr );  
//...  
BSTR bstrStatus;  
pBrowser->get_StatusText( &bstrStatus );  
   
// shows using the Win32 function  
// to freee the memory for the string:  
::SysFreeString( bstrStatus );

·  如果你实现一个返回BSTR的函数,在函数内部分配内存但不要释放。调用者负责释放。例如:

// Example shows using MFC's  
// CString::AllocSysString  
   
//...  
HRESULT CMyClass::get_StatusText( BSTR * pbstr )  
{  
   try  
   {  
      //m_str is a CString in your class  
      *pbstr = m_str.AllocSysString( );  
      }  
   catch (...)  
   {  
      return E_OUTOFMEMORY;  
   }  
// The client is now responsible for freeing pbstr.  
return( S_OK );  
}  
//...

·   时刻牢记BSTR是一个指针,而不是一个对象。尽量减少使用BSTR作为结构体或类的成员变量。如果必须使用,一定要认真考虑如何分配和释放。

 

5.下面介绍一种比较复杂的情况,利于对问题的深入理解。例如我们现在用到的ICF底层库就有很多类似下面的函数:

void CTestDlg::GetString(BSTR* state)
{
       _bstr_t m_state(L"cc");
       *state = m_state.copy();
}

其中_bstr_t的copy函数其实调用了SysAllocStringByteLen,所以需要此函数的调用者去进行释放。

释放时需要特别注意,像如下这两种调用方法都是正确的:

(1)

CComBSTR str;
GetString(&str);

(2)

BSTR str1;
GetString(&str1);
_bstr_t  str2(str1, false);

在第一种情况中,CComBSTR被强制转换为BSTR后接受了m_state.copy()返回的字符指针,同时SysAllocStringByteLen被调用了一次,而当其被析构时,SysFreeString被自动调用。所以这种调用方法最终保证了BSTR字符串的正确分配与释放。

在第二中情况中,变量str1接受了m_state.copy()返回的字符指针,同时SysAllocStringByteLen被调用了一次,而在_bstr_t类型变量str2的构造函数中,第二个参数为false,这表示构造函数不再调用SysAllocString,而当其被析构时,SysFreeString被自动调用。所以这种调用方法也是正确的。

而当一个类有一个CComBSTR类型的成员变量时,下面这种调用是错误的:

(3)

GetString(&m_str);

因为,它可能被调用多次,每次都执行了SysAllocStringByteLen,但成员变量只会析构一次,所以这样做的问题是会导致内存泄漏,正确的使用方法如下:

(4)

CComBSTR str;
GetString(&str);
m_str = str;

这样使用之所以正确,是因为CComBSTR被赋值时,会调用SysFreeString将其原来的字串释放,并调用SysAllocString,为其分配新的字串。

调用Com接口方法,输入参数中有BSTR参数时的调用方法。 

 // 1.   
 _bstr_t strName = BATCHUNIT_CALC_NAME;  
 TEST_ASSERT (S_OK == machine->GetUnit(strName, &pUnit));  
   
 // 2.  
 CComBSTR cbstrName = BATCHUNIT_CALC_NAME;  
 TEST_ASSERT (S_OK == machine->GetUnit(cbstrName, &pUnit));  
   
 // 3.  
 TEST_ASSERT (S_OK == machine->GetUnit(_bstr_t(BATCHUNIT_CALC_NAME), &pUnit));  
   
 // 4.  
 CString csName = BATCHUNIT_CALC_NAME;  
 TEST_ASSERT (S_OK == machine->GetUnit(_bstr_t(csName), &pUnit));

调用Com接口方法,输出参数中有BSTR参数时的调用方法。 

// 1.  
CComBSTR strRet21 = NULL;  
machine->GetParameter(_bstr_t(L"WaitForEachApply"), &(strRet21.m_str));  
  
// 2.  
BSTR strRet20 = NULL;  
machine->GetParameter(_bstr_t(L"WaitForEachApply"), &strRet20);  
_bstr_t strUse(strRet20, false);

函数的参数中有BSTR和BSTR*

STDMETHODIMP BatchMachine::GetParameter(BSTR strName, BSTR *strValue)  
{  
 AFX_MANAGE_STATE(AfxGetStaticModuleState())  
   
 CString csName = strName;  
 CString csValue = L"";  
 HRESULT hRet = GetParameterInternal(csName, csValue);  
 *strValue = csValue.AllocSysString();  
 CHECK_HRESULT( hRet, E_FAIL )  
 return S_OK;   
}

(End)

上一页 1 2 下一页

VC BSTR Char CString 转换

分享到:
评论加载中,请稍后...
创APP如搭积木 - 创意无限,梦想即时!
回到顶部