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" )

 

本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/bichenggui/archive/2009/09/16/4559542.aspx

你可能感兴趣的:(数据结构,C++,c,C#,mfc)