CHString 類別

[ CHString 類別是 WMI 提供者架構的一部分，現在被視為最終狀態，而且不會針對影響這些程式庫的非安全性相關問題使用進一步的開發、增強功能或更新。 MI API應該用於所有新的開發。]

下表列出 CHString 方法。

成員

CHString類別具有下列類型的成員：

• 建構函式
• 方法
• 運算子

建構函式

CHString類別具有這些建構函式。

建構函式	描述
CHString	以各種方式建構 CHString 字串。

方法

CHString類別具有這些方法。

方法	描述
AllocSysString	從 CHString 資料配置 BSTR 。
整理	比較兩個字串 (區分大小寫;使用地區設定特定的資訊) 。
比較	比較兩個字串 (區分大小寫) 。
CompareNoCase	比較兩個字串， (不區分大小寫的) 。
空白	強制字串長度為 0 (零) 長度。
找到	多載。 在較大的字串內尋找字元或子字串。
FindOneOf	從集合中尋找第一個相符字元。
格式	多載。 將字串格式化為 sprintf 。
FormatMessageW	多載。 格式化訊息字串。
FormatV	將字串格式化為 vsprintf 。
FreeExtra	釋放先前配置給字串的任何額外記憶體，以移除此字串的任何額外負荷。
GetAllocLength	傳回字串緩衝區的大小。
GetAt	多載。 傳回位於指定位置的字元。
GetBuffer	傳回 CHString 字串中字元的指標。
GetBufferSetLength	傳回 CHString 字串中字元的指標，並截斷為指定的長度。
GetData	傳回 CHString 字串中資料的指標。
GetLength	傳回 CHString 字串中的 Unicode 字元數目。
IsEmpty	測試 CHString 字串是否不含任何字元。
離開	擷取字串的左邊部分 (，例如基本 LEFT$ 函式) 。
LoadStringW	從資源檔載入現有的 CHString 字串。
LockBuffer	停用參考計數，並保護緩衝區中的字串。
MakeLower	將此字串中的所有字元轉換為小寫字元。
MakeReverse	反轉此字串中的字元。
MakeUpper	將這個字串中的所有字元轉換為大寫字元。
Mid	多載。 擷取字串的中間部分 (，例如基本 MID$ 函式) 。
ReleaseBuffer	釋放 GetBuffer所傳回之緩衝區的控制權。
ReverseFind	在較大的字串內尋找字元;從結尾開始。
Right	擷取字串的右邊部分 (，例如基本 RIGHT$ 函式) 。
SetAt	在指定位置設定字元。
SpanExcluding	擷取子字串，其中只包含不在集合中的字元。
SpanIncluding	擷取只包含集合中字元的子字串。
TrimLeft	修剪字串中的前置空白字元。
TrimRight	修剪字串中的尾端空白字元。
UnlockBuffer	啟用參考計數，並釋放緩衝區中的字串。

運算子

The **CHString** class has these operators.

運算子	描述
operator ！= (CHString， CHString)	比較兩個 CHString 來 表示不相等。
operator ！= (CHString， LPCWSTR)	比較 CHString 與 LPCWSTR 是否不相等。
運算子 []	傳回 GetAt之指定位置運算子替代位置的字元。
運算子 +	串連兩個字串，並傳回新的字串。
運算子 +=	將新的字串串連至現有字串的結尾。
operator < (CHString， LPCWSTR)	比較 CHString 與 LPCWSTR。
運算子 < (CHString、 CHString)	比較兩個 CHString。
operator < = (CHString、CHString)	比較兩個 CHString。
operator < = (CHString， LPCWSTR)	比較 CHString 與 LPCWSTR。
operator =	將新值指派給 CHString 字串。
operator == (CHString， CHString)	比較兩個 CHString 是否 相等。
operator == (CHString， LPCWSTR)	比較 CHString 與 LPCWSTR 是否相等。
運算子 > (CHString、 CHString)	比較兩個 CHString。
operator > (CHString， LPCWSTR)	比較 CHString 與 LPCWSTR。
operator > = (CHString、CHString)	比較兩個 CHString。
operator > = (CHString， LPCWSTR)	比較 CHString 與 LPCWSTR。
運算子 LPCWSTR	直接存取以 C 樣式字串儲存在 CHString 字串中的字元。

備註

類別的解構函式是 CHString：：~CHString。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
標頭	ChString.h (包含 FwCommon.h)
程式庫	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll