共用方式為

CStringData 類別

  • 發行項

這個類別表示字串物件的資料。

struct CStringData

Members

494hzt3b.collapse_all(zh-tw,VS.110).gif方法

AddRef

將字串資料物件的參考計數。

data

擷取字串物件的字元資料。

IsLocked

判斷關聯字串物件的緩衝區是否已鎖定。

IsShared

判斷關聯字串物件的緩衝區目前是否為共用。

鎖定

鎖定關聯字串物件的緩衝區。

Release

釋放指定的字串物件。

解除鎖定

開啟關聯字串物件的緩衝區。

494hzt3b.collapse_all(zh-tw,VS.110).gif資料成員

nAllocLength

配置之資料的長度 (以 XCHARs 的 (不包含結尾 null)

nDataLength

在 XCHARs 的目前所使用之資料的長度 (包括 null 終止)

nRefs

目前物件的參考計數。

pStringMgr

將這個字串物件的資料處理常式之的指標。

備註

應該是實作自訂字串處理常式的開發人員只使用此類別。 如需自訂字串處理常式的詳細資訊，請參閱 記憶體管理和 CStringT

這個類別會封裝資訊的各種類型，而資料與較高的字串物件，例如、或 CStringTCSimpleStringTCFixedStringT 物件。 每個較高的字串物件含有指向其關聯的 CStringData 物件，允許對多點的字串物件為相同的字串資料物件。 此關聯性可由參考計數 (nRefs) 表示 CStringData 物件。

注意事項注意事項

在某些案例中，資料型別 (例如) CFixedString擁有超過一個以上的字串物件不會共用資料的資料物件。如需詳細資訊，請參閱 記憶體管理和 CStringT。

這項資料所組成:

  • 記憶體管理員 (屬於型別 IAtlStringMgr) 的字串。

  • 目前長度 (nDataLength) 的字串。

  • 配置的長度 (nAllocLength) 的字串。 基於效能考量，這可以與目前的長度不同。

  • 目前參考計數 (nRefs) CStringData 物件。 這個值用於判斷字串物件共用相同的 CStringData 物件。

  • 實際字元緩衝區 (資料) 字串。

    注意事項注意事項

    字串處理常式配置字串物件的實際字元緩衝區和附加至 CStringData 物件。

需求

Header: atlsimpstr.h

請參閱

參考

階層架構圖

其他資源

ATL/MFC 共用類別