BSTR

BSTR（Basic String）是一種Pascal-Style字串（明確標示字串長度）和C-Style字串（以\0結尾）的混合物，一般用於COM中，是Unicode字串，即標示字串長度，最後還有一個值為\0位元組。

對於BSTR，NULL與""有相同的語意（Visual Basic引入的語意）。BSTR的長度不包含結尾的\0位元組。BSTR必須用SysAlloc*作業系統API申請與釋放。

引論

C-Style 字串

C程式語言本身原並不支援字串資料結構。字串通常以一個字元數組（或稱陣列）或一個指向字元資料的指標來表達。由於C語言的數組不包含其長度的資訊，故亦無法表示所載之字串之長度。C語言社群對此通用之解決方案為於字串末端增添一數值0的字元。C語言的標準程式庫中的字串處理功能亦以此為基礎。C-Style 字串特點為不直接包含長度資訊。要取得字串之長度，就必須從頭到尾數算字元數目，直到遇到字元0為止。由於不設長度資訊，故C-style 字串的長度理論上可以無上限。

Pascal-style 字串

Pascal程式語言採取另一種方向處理字串。在儲存字串的記憶空間的開首，儲存一固定長度整數以表達其長度。如此Pascal-style 字串不需要在最後增添額外字元以標明其結束。但由於字串開首儲存字串長度的空間有限，故Pascal-style 的字串長度有上限。但在獲得字串長度方面有速度優勢。

BSTR 字串

BSTR 字串結合了C-style 字串和Pascal-style字串。它在前4位元組儲存了字串長度（字串的位元組數，但不包括Null結束符），在字串結尾以字元0識別。和pascal-style 字串不同，指向BSTR字串的指標指向第一個字元，而非開首的字串長度。故此適用於讀取C-style 字串的程式庫同樣適用於BSTR字串（但寫入則另作別論）。 字元是按照Unicode編碼儲存。允許在BSTR串中間嵌入NULL字元。

Windows提供了BSTR相關函式：

• 分配空間並初始化BSTR，這也相當於char*轉換成BSTR：例如，BSTR bstrText = ::SysAllocString(L"Test");
• BSTR SysAllocString(const OLECHAR * psz);
• INT SysReAllocString(BSTR* pbstr,const OLECHAR* psz);
• BSTR SysAllocStringLen(const OLECHAR * strIn, UINT ui);
• INT SysReAllocStringLen(BSTR* pbstr,const OLECHAR* psz,unsigned int len);
• void SysFreeString(BSTR bstrString);
• UINT SysStringLen(BSTR); //長度是指字串中字元個數，而非位元組數
• UINT SysStringByteLen(BSTR bstr); 長度是指字串中位元組數
• BSTR SysAllocStringByteLen(LPCSTR psz,UINT len);
• 使用_variant_t把char*轉換成BSTR：例如，_variant_t strVar("This is a test"); BSTR bstrText = strVar.bstrVal;
• 使用_bstr_t函式，例如： BSTR bstrText = _bstr_t("This is a test");
• 使用ATL中專門用於操作BSTR字元的CComBSTR類：例如BSTR bstrText = CComBSTR("This is a test");
• 使用ConvertStringToBSTR。例如： char* lpszText = "Test"; BSTR bstrText = _com_util::ConvertStringToBSTR(lpszText);
• 使用ConvertBSTRToString：例如，char* lpszText2 = _com_util::ConvertBSTRToString(bstrText);
• 使用_bstr_t的類型轉換運算子多載把BSTR轉換成char*：例如， char* lpszText2 = bstrText;
• CString轉換成BSTR通常是通過使用CStringT::AllocSysString來實現。例如：CString str("This is a test");BSTR bstrText = str.AllocSysString();
• BSTR轉換成CString，例如：CStringA str=bstrText;

參考文獻

• [//web.archive.org/web/20070711151336/http://msdn2.microsoft.com/en-us/library/ms221069.aspx 頁面存檔備份，存於網際網路檔案館） MSDN]
• C String（頁面存檔備份，存於網際網路檔案館）
• What are VB String