C-style strings and typedefs

正如我在第一部分中提到的，windows APIs 是用TCHARs来定义的，在编译时，它可以根据你是否定义_MBCS或者_UNICODE被编译成MBCS或者Unicode字符。你可以参看第一部分中对TCHAR的完整描述，这里为了方便，我列出了字符的typedefs

一个增加的字符类型是OLETYPE。它表示自动化接口（如word提供的可以使你操作文档的接口）中使用的字符类型。这种类型一般被定义成 wchar_t，然而如果你定义了OLE2ANSI预处理标记，OLECHAR将会被定义成char类型。我知道现在已经没有理由定义OLE2ANSI （从MFC3以后，微软已经不使用它了），所以从现在起我将把OLECHAR当作Unicode字符。
这里给出你将会看到的一些OLECHAR相关的typedefs：

还有两个用于包围字符串和字符常量的宏定义，它们可以使同样的代码被用于MBCS和Unicode builds ：

Type
Meaning

?

在文档或例程中，你还会看到好多_T的变体。有四个等价的宏定义，它们是TEXT, _TEXT, __TEXT和__T，它们都起同样的做用。

COM 中的字符串 —— BSTR 和 VARIANT

很多自动化和COM接口使用BSTR来定义字符串。BSTRs中有几个"陷阱"，所以这里我用单独的部分来说明它。
BSTR 是 Pascal-style 字符串（字符串长度被明确指出）和C-style字符串（字符串的长度要通过寻找结束符来计算）的混合产物。一个BSTR是一个Unicode字符串，它的长度是预先考虑的，并且它还有一个0字符作为结束标记。下面是一个BSTR的示例：

?

注意字符串的长度是如何被加到字符串数据中的。长度是DWORD类型的，保存了字符串中包含的字节数，但不包括结束标记。在这个例子中，"Bob"包含 3个Unicode字符（不包括结束符），总共6个字节。字符串的长度被预先存储好，以便当一个BSTR在进程或者计算机之间被传递时，COM库知道多少数据需要传送。（另一方面，一个BSTR能够存储任意数据块，而不仅仅是字符，它还可以包含嵌入在数据中的0字符。然而，由于这篇文章的目的，我将不考虑那些情况）。
在 C++ 中，一个 BSTR 实际上就是一个指向字符串中第一个字符的指针。它的定义如下：

BSTR bstr = NULL;
bstr = SysAllocString ( L"Hi Bob!" );
if ( NULL == bstr )
// out of memory error
// Use bstr here...
SysFreeString ( bstr );

// Constructing
_bstr_t bs1 = "char string";?????? // construct from a LPCSTR
_bstr_t bs2 = L"wide char string"; // construct from a LPCWSTR
_bstr_t bs3 = bs1;???????????????? // copy from another _bstr_t
_variant_t v = "Bob";
_bstr_t bs4 = v;?????????????????? // construct from a _variant_t that has a string

// Extracting data
LPCSTR psz1 = bs1;????????????? // automatically converts to MBCS string
LPCSTR psz2 = (LPCSTR) bs1;???? // cast OK, same as previous line
LPCWSTR pwsz1 = bs1;??????????? // returns the internal Unicode string
LPCWSTR pwsz2 = (LPCWSTR) bs1;? // cast OK, same as previous line
BSTR??? bstr = bs1.copy();????? // copies bs1, returns it as a BSTR

// ...
SysFreeString ( bstr );?????

// Constructing
_variant_t v1 = "char string";?????? // construct from a LPCSTR
_variant_t v2 = L"wide char string"; // construct from a LPCWSTR
_bstr_t bs1 = "Bob";
_variant_t v3 = bs1;???????????????? // copy from a _bstr_t object

// Extracting data
_bstr_t bs2 = v1;?????????? // extract BSTR from the VARIANT
_bstr_t bs3 = (_bstr_t) v1; // cast OK, same as previous line

?

// Specializations
typedef basic_string tstring; // string of TCHARs

// Constructing
string str = "char string";???????? // construct from a LPCSTR
wstring wstr = L"wide char string"; // construct from a LPCWSTR
tstring tstr = _T("TCHAR string");? // construct from a LPCTSTR

// Extracting data
LPCSTR psz = str.c_str();??? // read-only pointer to str''s buffer
LPCWSTR pwsz = wstr.c_str(); // read-only pointer to wstr''s buffer
LPCTSTR ptsz = tstr.c_str(); // read-only pointer to tstr''s buffer

// Example, construct _bstr_t from basic_string
_bstr_t bs1 = str.c_str();? // construct a _bstr_t from a LPCSTR
_bstr_t bs2 = wstr.c_str(); // construct a _bstr_t from a LPCWSTR??

// Sample interface:
struct IStuff : public IUnknown
{
??? // Boilerplate COM stuff omitted...
??? STDMETHOD(SetText)(BSTR bsText);
??? STDMETHOD(GetText)(BSTR* pbsText);
};?????

CComBSTR bs1;
CComBSTR bs2 = "new text";

pStuff->GetText ( &bs1 );?????? // ok, takes address of internal BSTR
pStuff->SetText ( bs2 );??????? // ok, calls BSTR converter
pStuff->SetText ( (BSTR) bs2 ); // cast ok, same as previous line??

// Constructing
CComBSTR bs1 = "char string";?????? // construct from a LPCSTR
CComBSTR bs2 = L"wide char string"; // construct from a LPCWSTR
CComBSTR bs3 = bs1;???????????????? // copy from another CComBSTR
CComBSTR bs4;

bs4.LoadString ( IDS_SOME_STR );? // load string from string table
// Extracting data
BSTR bstr1 = bs1;??????? // returns internal BSTR, but don''t modify it!
BSTR bstr2 = (BSTR) bs1; // cast ok, same as previous line
BSTR bstr3 = bs1.Copy(); // copies bs1, returns it as a BSTR
BSTR bstr4;
bstr4 = bs1.Detach();? // bs1 no longer manages its BSTR
// ...
SysFreeString ( bstr3 );
SysFreeString ( bstr4 );??

std::list< CAdapt<CComBSTR> > bstr_list;

A: MBCS string, char* (A for ANSI)

W: Unicode string, wchar_t* (W for wide)

T: TCHAR string, TCHAR*

OLE: OLECHAR string, OLECHAR* (in practice, equivalent to W)

BSTR: BSTR (used as the destination type only)

CStringT ( System::String* pString );???