BSTR、LPSTR和LPWSTR

 

一、   BSTR、LPSTR和LPWSTR 　　
在Visual C++.NET的所有编程方式中，我们常常要用到这样的一些基本字符串类型，如BSTR、LPSTR和LPWSTR等。之所以出现类似上述的这些数据类型，是因为不同编程语言之间的数据交换以及对ANSI、Unicode和多字节字符集(MBCS)的支持。

那么什么是BSTR、LPSTR以及LPWSTR呢？　　

BSTR(Basic STRing，Basic字符串)是一个OLECHAR*类型的Unicode字符串。它被描述成一个与自动化相兼容的类型。由于操作系统提供相应的API函数(如SysAllocString)来管理它以及一些默认的调度代码，因此BSTR实际上就是一个COM字符串，但它却在自动化技术以外的多种场合下得到广泛使用。图1描述了BSTR的结构，其中DWORD值是字符串中实际所占用的字节数，且它的值是字符串中Unicode字符的两倍。

LPSTR和LPWSTR是Win32和VC++所使用的一种字符串数据类型。LPSTR被定义成是一个指向以NULL(‘/0’)结尾的8位ANSI字符数组指针，而LPWSTR是一个指向以NULL结尾的16位双字节字符数组指针。在VC++中，还有类似的字符串类型，如LPTSTR、LPCTSTR等，它们的含义如图2所示。

　　例如，LPCTSTR是指“long pointer to a constant generic string”，表示“一个指向一般字符串常量的长指针类型”，与C/C++的const char*相映射，而LPTSTR映射为 char*。

　　一般地，还有下列类型定义：

#ifdef UNICODE

　 typedef LPWSTR LPTSTR;

　 typedef LPCWSTR LPCTSTR;

#else

　 typedef LPSTR LPTSTR;

　 typedef LPCSTR LPCTSTR;

#endif

二、CString、CStringA 和 CStringW　　
Visual C++.NET中将CStringT作为ATL和MFC的共享的“一般”字符串类，它有CString、CStringA和CStringW三种形式，分别操作不同字符类型的字符串。这些字符类型是TCHAR、char和wchar_t。TCHAR在Unicode平台中等同于WCHAR(16位Unicode字符)，在ANSI中等价于char。wchar_t通常定义为unsigned short。由于CString在MFC应用程序中经常用到，这里不再重复。

三、VARIANT、COleVariant 和_variant_t
在OLE、ActiveX和COM中，VARIANT数据类型提供了一种非常有效的机制，由于它既包含了数据本身，也包含了数据的类型，因而它可以实现各种不同的自动化数据的传输。下面让我们来看看OAIDL.H文件中VARIANT定义的一个简化版：

struct tagVARIANT {

　 VARTYPE vt;

　 union {

　　 short iVal; // VT_I2.

　　 long lVal; // VT_I4.

　　 float fltVal; // VT_R4.

　　 double dblVal; // VT_R8.

　　 DATE date; // VT_DATE.

　　 BSTR bstrVal; // VT_BSTR.

　　 …

　　 short * piVal; // VT_BYREF|VT_I2.

　　 long * plVal; // VT_BYREF|VT_I4.

　　 float * pfltVal; // VT_BYREF|VT_R4.

　　 double * pdblVal; // VT_BYREF|VT_R8.

　　 DATE * pdate; // VT_BYREF|VT_DATE.

　　 BSTR * pbstrVal; // VT_BYREF|VT_BSTR.

　 };

};

　　显然，VARIANT类型是一个C结构，它包含了一个类型成员vt、一些保留字节以及一个大的union类型。例如，如果vt为VT_I2，那么我们可以从iVal中读出VARIANT的值。同样，当给一个VARIANT变量赋值时，也要先指明其类型。例如：

VARIANT va;

:: VariantInit(&va); // 初始化

int a = 2002;

va.vt = VT_I4; // 指明long数据类型

va.lVal = a; // 赋值

　　为了方便处理VARIANT类型的变量，Windows还提供了这样一些非常有用的函数：

　　VariantInit —— 将变量初始化为VT_EMPTY；

　　VariantClear —— 消除并初始化VARIANT；

　　VariantChangeType —— 改变VARIANT的类型；

　　VariantCopy —— 释放与目标VARIANT相连的内存并复制源VARIANT。

 

COleVariant类是对VARIANT结构的封装。它的构造函数具有极为强大的功能，当对象构造时首先调用VariantInit进行初始化，然后根据参数中的标准类型调用相应的构造函数，并使用VariantCopy进行转换赋值操作，当VARIANT对象不在有效范围时，它的析构函数就会被自动调用，由于析构函数调用了VariantClear，因而相应的内存就会被自动清除。除此之外，COleVariant的赋值操作符在与VARIANT类型转换中为我们提供极大的方便。例如下面的代码：

COleVariant v1("This is a test"); // 直接构造

COleVariant v2 = "This is a test"; // 结果是VT_BSTR类型，值为"This is a test"

COleVariant v3((long)2002);

COleVariant v4 = (long)2002;// 结果是VT_I4类型，值为2002

 

_variant_t是一个用于COM的VARIANT类，它的功能与COleVariant相似。不过在Visual C++.NET的MFC应用程序中使用时需要在代码文件前面添加下列两句：　　#include "comutil.h"　　#pragma comment( lib, "comsupp.lib" )

四、BSTR、CComBSTR和_bstr_t　　
CComBSTR是对BSTR数据类型封装的一个ATL类，它的操作比较方便。例如：

CComBSTR bstr1; bstr1 = "Bye"; // 直接赋值

OLECHAR* str = OLESTR("ta ta"); // 长度为5的宽字符

CComBSTR bstr2(wcslen(str)); // 定义长度为5

wcscpy(bstr2.m_str, str); // 将宽字符串复制到BSTR中

CComBSTR bstr3(5, OLESTR("Hello World"));

CComBSTR bstr4(5, "Hello World");

CComBSTR bstr5(OLESTR("Hey there"));

CComBSTR bstr6("Hey there");

CComBSTR bstr7(bstr6); // 构造时复制，内容为"Hey there"

 

_bstr_t是C++对BSTR的封装，它的构造和析构函数分别调用SysAllocString和SysFreeString函数，其他操作是借用BSTR API函数。与_variant_t相似，使用时也要添加comutil.h和comsupp.lib。

五、BSTR、char*和CString转换　　
(1)      char*转换成CString　　

若将char*转换成CString，除了直接赋值外，还可使用CString::Format进行。例如：

char chArray[] = "This is a test";

char * p = "This is a test"; 　　或    LPSTR p = "This is a test";

或在已定义Unicode应的用程序中TCHAR * p = _T("This is a test");

　　或LPTSTR p = _T("This is a test");

CString theString = chArray;

theString.Format(_T("%s"), chArray);

theString = p; 　　

(2)      CString转换成char*

若将CString类转换成char*(LPSTR)类型，常常使用下列三种方法：

 

方法一，使用强制转换。例如：

CString theString( "This is a test" );

LPTSTR lpsz =(LPTSTR)(LPCTSTR)theString; 　　

 

方法二，使用strcpy。

例如：CString theString( "This is a test" );

LPTSTR lpsz = new TCHAR[theString.GetLength()+1];

_tcscpy(lpsz, theString);

需要说明的是，strcpy(或可移值Unicode/MBCS的_tcscpy)的第二个参数是 const wchar_t* (Unicode)或const char* (ANSI)，系统编译器将会自动对其进行转换。　　

 

方法三，使用CString::GetBuffer。例如：

CString s(_T("This is a test "));

LPTSTR p = s.GetBuffer();

// 在这里添加使用p的代码

if(p != NULL) *p = _T('/0');

s.ReleaseBuffer();

// 使用完后及时释放，以便能使用其它的CString成员函数

(3)      BSTR转换成char*　　

方法一，使用ConvertBSTRToString。例如：

#include

#pragma comment(lib, "comsupp.lib")

 

int _tmain(int argc, _TCHAR* argv[]){

BSTR bstrText = ::SysAllocString(L"Test");

char* lpszText2 = _com_util::ConvertBSTRToString(bstrText);

SysFreeString(bstrText); // 用完释放

delete[] lpszText2;

return 0;

}　　

 

方法二，使用_bstr_t的赋值运算符重载。例如：

_bstr_t b = bstrText;

char* lpszText2 = b; 　　

(4)      char*转换成BSTR

方法一，使用SysAllocString等API函数。例如：

    BSTR bstrText = ::SysAllocString(L"Test");

    BSTR bstrText = ::SysAllocStringLen(L"Test",4);

    BSTR bstrText = ::SysAllocStringByteLen("Test",4);

 

方法二，使用COleVariant或_variant_t。例如：

//COleVariant strVar("This is a test");

_variant_t strVar("This is a test");

BSTR bstrText = strVar.bstrVal; 　　

 

方法三，使用_bstr_t，这是一种最简单的方法。例如：

BSTR bstrText = _bstr_t("This is a test");

 

方法四，使用CComBSTR。例如：

BSTR bstrText = CComBSTR("This is a test");

　　或CComBSTR bstr("This is a test");

BSTR bstrText = bstr.m_str;

 

方法五，使用ConvertStringToBSTR。例如：

char* lpszText = "Test";

BSTR bstrText = _com_util::ConvertStringToBSTR(lpszText);

 

(5)      CString转换成BSTR

通常是通过使用CStringT::AllocSysString来实现。例如：

CString str("This is a test");

BSTR bstrText = str.AllocSysString();

…

SysFreeString(bstrText); // 用完释放

(6)      BSTR转换成CString

一般可按下列方法进行：

    BSTR bstrText = ::SysAllocString(L"Test");

    CStringA str;

    str.Empty();

    str = bstrText;

　　或CStringA str(bstrText);

(7)      ANSI、Unicode和宽字符之间的转换

方法一，使用MultiByteToWideChar将ANSI字符转换成Unicode字符，使用WideCharToMultiByte将Unicode字符转换成ANSI字符。

 

方法二，使用“_T”将ANSI转换成“一般”类型字符串，使用“L”将ANSI转换成Unicode，而在托管C++环境中还可使用S将ANSI字符串转换成String*对象。例如：

TCHAR tstr[] = _T("this is a test");

wchar_t wszStr[] = L"This is a test";

String* str = S”This is a test”;

 

方法三，使用ATL 7.0的转换宏和类。ATL7.0在原有3.0基础上完善和增加了许多字符串转换宏以及提供相应的类，它具有如图3所示的统一形式：　其中，第一个C表示“类”，以便于ATL 3.0宏相区别，第二个C表示常量，2表示“to”，EX表示要开辟一定大小的缓冲。SourceType和DestinationType可以是A、T、W和OLE，其含义分别是ANSI、Unicode、“一般”类型和OLE字符串。例如，CA2CT就是将ANSI转换成一般类型的字符串常量。下面是一些示例代码：

LPTSTR tstr= CA2TEX<16>("this is a test");

LPCTSTR tcstr= CA2CT("this is a test");

wchar_t wszStr[] = L"This is a test";

char* chstr = CW2A(wszStr);

 

 

 

 

我们先定义一些常见类型变量借以说明

int i = 100;

long l = 2001;

float f=300.2;

double d=12345.119;

char username[]="程佩君";

char temp[200];

char *buf;

CString str;

_variant_t v1;

_bstr_t v2;

 

一、其它数据类型转换为字符串
短整型(int)

itoa(i,temp,10);///将i转换为字符串放入temp中,最后一个数字表示十进制

itoa(i,temp,2); ///按二进制方式转换

长整型(long)

ltoa(l,temp,10);

浮点数(float,double)

用fcvt可以完成转换,这是MSDN中的例子:

int decimal, sign;

char *buffer;

double source = 3.1415926535;

buffer = _fcvt( source, 7, &decimal, &sign );

运行结果:source: 3.1415926535 buffer: '31415927' decimal: 1 sign: 0

decimal表示小数点的位置,sign表示符号:0为正数，1为负数

CString变量

str = "2008北京奥运";

buf = (LPSTR)(LPCTSTR)str;

BSTR变量

BSTR bstrValue = ::SysAllocString(L"程序员");

char * buf = _com_util::ConvertBSTRToString(bstrValue);

SysFreeString(bstrValue);

AfxMessageBox(buf);

delete(buf);

CComBSTR变量

CComBSTR bstrVar("test");

char *buf = _com_util::ConvertBSTRToString(bstrVar.m_str);

AfxMessageBox(buf);

delete(buf);

 

 

_bstr_t变量

_bstr_t类型是对BSTR的封装，因为已经重载了=操作符，所以很容易使用

_bstr_t bstrVar("test");

const char *buf = bstrVar;///不要修改buf中的内容

AfxMessageBox(buf);

 

通用方法(针对非COM数据类型)，用sprintf完成转换

char  buffer[200];

char  c = '1';

int   i = 35;

long  j = 1000;

float f = 1.7320534f;

sprintf( buffer, "%c",c);

sprintf( buffer, "%d",i);

sprintf( buffer, "%d",j);

sprintf( buffer, "%f",f);

 

二、字符串转换为其它数据类型
strcpy(temp,"123");

 

短整型(int)    i = atoi(temp);

长整型(long)  l = atol(temp);

浮点(double)  d = atof(temp);

CString变量  CString name = temp;

BSTR变量    BSTR bstrValue = ::SysAllocString(L"程序员");

...///完成对bstrValue的使用

SysFreeString(bstrValue);

buf = _com_util::ConvertBSTRToString((_bstr_t)v1);

CComBSTR变量，CComBSTR类型变量可以直接赋值

CComBSTR bstrVar1("test");

CComBSTR bstrVar2(temp);

 

_bstr_t变量，_bstr_t类型的变量可以直接赋值

_bstr_t bstrVar1("test");

_bstr_t bstrVar2(temp);

 

三、其它数据类型转换到CString
使用CString的成员函数Format来转换,例如:

整数(int)，

str.Format("%d",i);

浮点数(float)，

str.Format("%f",i);

字符串指针(char *)等已经被CString构造函数支持的数据类型可以直接赋值

str = username;

对于Format所不支持的数据类型，可以通过上面所说的关于其它数据类型转化到char *的方法先转到char *，然后赋值给CString变量。

 

四、BSTR、_bstr_t与CComBSTR
CComBSTR 是ATL对BSTR的封装，_bstr_t是C++对BSTR的封装,BSTR是32位指针,但并不直接指向字串的缓冲区。

char *转换到BSTR可以这样:

BSTR b=_com_util::ConvertStringToBSTR("数据");///使用前需要加上comutil.h和comsupp.lib

SysFreeString(bstrValue);

反之可以使用

char *p=_com_util::ConvertBSTRToString(b);

delete p;

具体可以参考一，二段落里的具体说明。

 

CComBSTR与_bstr_t对大量的操作符进行了重载，可以直接进行=,!=,==等操作，所以使用非常方便。

特别是_bstr_t,建议大家使用它。

 

五、VARIANT 、_variant_t 与 COleVariant
VARIANT的结构可以参考头文件VC98/Include/OAIDL.H中关于结构体tagVARIANT的定义。

对于VARIANT变量的赋值：首先给vt成员赋值，指明数据类型，再对联合结构中相同数据类型的变量赋值，举个例子：

VARIANT va;

int a=2001;

va.vt=VT_I4;///指明整型数据

va.lVal=a; ///赋值

 

对于不马上赋值的VARIANT，最好先用Void VariantInit(VARIANTARG FAR* pvarg);进行初始化,其本质是将vt设置为VT_EMPTY,下表我们列举vt与常用数据的对应关系:

unsigned char  bVal
 VT_UI1
 
unsigned char FAR* pbVal
 VT_BYREF|VT_UI1
 
char cVal
 VT_I1
 
char FAR * pcVal
 VT_BYREF|VT_I1
unsigned short  iVal;
 VT_UI2
 
unsigned short FAR * puiVal
 VT_BYREF|VT_UI2
 
short  iVal;
 VT_I2
 
short FAR* piVal
 VT_BYREF|VT_I2
 
 
 
 
unsigned long  lVal
 VT_UI4
 
unsigned long FAR * pulVal
 VT_BYREF|VT_UI4
 
long  lVal
 VT_I4
 
long FAR* plVal
 VT_BYREF|VT_I4
 
 
 
 
unsigned int uintVal
 VT_UINT
 
unsigned int FAR * puintVal
 VT_BYREF|VT_UINT
 
int  intVal
 VT_INT
 
int  FAR * pintVal
 VT_BYREF|VT_INT
 
 
 
 
float  fltVal
 VT_R4
 
float FAR* pfltVal
 VT_BYREF|VT_R4
 
 
 
 
double  dblVal
 VT_R8
 
double FAR* pdblVal
 VT_BYREF|VT_R8
 
 
 
 
VARIANT_BOOL  boolVal
 VT_BOOL
 
VARIANT_BOOL FAR* pboolVal
 VT_BYREF|VT_BOOL
 
 
 
 
DATE  date
 VT_DATE
 
DATE FAR* pdate
 VT_BYREF|VT_DATE
 
 
 
 
BSTR  bstrVal
 VT_BSTR
 
BSTR FAR* pbstrVal
 VT_BYREF|VT_BSTR
 
 
 
 
CY  cyVal
 VT_CY
 
CY FAR* pcyVal
 VT_BYREF|VT_CY
 
 
 
 
DECIMAL FAR* pdecVal
 VT_BYREF|VT_DECIMAL
 
IUnknown FAR* punkVal
 VT_UNKNOWN
 
IDispatch FAR* pdispVal
 VT_DISPATCH
 
SAFEARRAY FAR* parray
 VT_ARRAY|*
 
IUnknown FAR* FAR* ppunkVal
 VT_BYREF|VT_UNKNOWN
 
IDispatch FAR* FAR* ppdispVal
 VT_BYREF|VT_DISPATCH
 
 
 
 
SCODE FAR* pscode
 VT_BYREF|VT_ERROR
 
SCODE  scode
 VT_ERROR

 

_variant_t是VARIANT的封装类，其赋值可以使用强制类型转换，其构造函数会自动处理这些数据类型。

使用时需加上#include <comdef.h>，例如：

long l=222;

ing i=100;

_variant_t lVal(l);

lVal = (long)i;

 

 

COleVariant的使用与_variant_t的方法基本一样，请参考如下例子：

COleVariant v3 = "字符串", v4 = (long)1999;

CString str =(BSTR)v3.pbstrVal;

long i = v4.lVal;

 

 

六、其它一些COM数据类型

根据ProgID得到CLSID

HRESULT CLSIDFromProgID( LPCOLESTR lpszProgID,LPCLSID pclsid);

CLSID clsid;

CLSIDFromProgID( L"MAPI.Folder",&clsid);

 

根据CLSID得到ProgID

WINOLEAPI ProgIDFromCLSID( REFCLSID clsid,LPOLESTR * lplpszProgID);

例如我们已经定义了 CLSID_IApplication,下面的代码得到ProgID

LPOLESTR pProgID = 0;

ProgIDFromCLSID( CLSID_IApplication,&pProgID);

...///可以使用pProgID

CoTaskMemFree(pProgID);//不要忘记释放

 

七、ANSI与Unicode
Unicode称为宽字符型字串,COM里使用的都是Unicode字符串。

 

将ANSI转换到Unicode

(1)通过L这个宏来实现，例如: CLSIDFromProgID( L"MAPI.Folder",&clsid);

(2)通过MultiByteToWideChar函数实现转换,例如:

char *szProgID = "MAPI.Folder";

WCHAR szWideProgID[128];

CLSID clsid;

long lLen = MultiByteToWideChar(CP_ACP,0,szProgID,strlen(szProgID),szWideProgID,sizeof(szWideProgID));

szWideProgID[lLen] = '/0';

(3)通过A2W宏来实现,例如:

USES_CONVERSION;

CLSIDFromProgID( A2W(szProgID),&clsid);

 

将Unicode转换到ANSI

(1)使用WideCharToMultiByte,例如:

// 假设已经有了一个Unicode 串 wszSomeString...

char szANSIString [MAX_PATH];

WideCharToMultiByte ( CP_ACP, WC_COMPOSITECHECK, wszSomeString, -1, szANSIString, sizeof(szANSIString), NULL, NULL );

(2)使用W2A宏来实现,例如:

USES_CONVERSION;

pTemp=W2A(wszSomeString);

八、其它

对消息的处理中我们经常需要将WPARAM或LPARAM等32位数据（DWORD)分解成两个16位数据（WORD),例如：

LPARAM lParam;

WORD loValue = LOWORD(lParam);///取低16位

WORD hiValue = HIWORD(lParam);///取高16位

 

 

对于16位的数据(WORD)我们可以用同样的方法分解成高低两个8位数据(BYTE),例如:

WORD wValue;

BYTE loValue = LOBYTE(wValue);///取低8位

BYTE hiValue = HIBYTE(wValue);///取高8位

 

 

两个16位数据（WORD）合成32位数据(DWORD, LRESULT, LPARAM,或WPARAM)

LONG MAKELONG( WORD wLow, WORD wHigh );

WPARAM MAKEWPARAM( WORD wLow, WORD wHigh );

LPARAM MAKELPARAM( WORD wLow, WORD wHigh );

LRESULT MAKELRESULT( WORD wLow, WORD wHigh );

 

 

两个8位的数据(BYTE)合成16位的数据(WORD)

WORD MAKEWORD( BYTE bLow, BYTE bHigh );

 

 

从R(red),G(green),B(blue)三色得到COLORREF类型的颜色值

COLORREF RGB( BYTE byRed,BYTE byGreen,BYTE byBlue );

例如COLORREF bkcolor = RGB(0x22,0x98,0x34);

 

 

从COLORREF类型的颜色值得到RGB三个颜色值

BYTE Red = GetRValue(bkcolor); ///得到红颜色

BYTE Green = GetGValue(bkcolor); ///得到绿颜色

BYTE Blue = GetBValue(bkcolor); ///得到兰颜色

 

九、注意事项
假如需要使用到ConvertBSTRToString此类函数,需要加上头文件comutil.h,并在setting中加入comsupp.lib或者直接加上#pragma comment( lib, "comsupp.lib" )