跳至內容

BSTR

本頁使用了標題或全文手工轉換
維基百科,自由的百科全書

BSTR(Basic String[1])是一種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;

參考文獻

[編輯]
  1. ^ Basic String的意思是Basic语言的字符串,见《Eric’s Complete Guide To BSTRSemantics》 by Eric Lippert, 2003年9月12日. [2018年9月9日]. (原始內容存檔於2018年9月9日).