共用方式為


CAtlMap 類別

這個類別會建立和管理對應物件的方法。

template<
   typename K,
   typename V,
   class KTraits = CElementTraits< K >,
   class VTraits = CElementTraits< V >
>
class CAtlMap

參數

  • K
    按鍵字元型別。

  • V
    值項目型別。

  • KTraits
    使用的程式碼複製或移動的要素。 如需的詳細資訊請參閱 CElementTraits 類別

  • VTraits
    使用的程式碼複製或移動的項目值。

Members

w6fwh89e.collapse_all(zh-tw,VS.110).gif公用 Typedefs

名稱

描述

CAtlMap::KINARGTYPE

使用的型別,當金鑰傳遞做為輸入引數

CAtlMap::KOUTARGTYPE

使用的型別,當索引鍵會傳回當做輸出引數。

CAtlMap::VINARGTYPE

使用的型別時,值就會當做輸入引數。

CAtlMap::VOUTARGTYPE

使用的型別時,值就會當做輸出引數。

w6fwh89e.collapse_all(zh-tw,VS.110).gif公用類別

名稱

描述

CAtlMap::CPair 類別

包含索引鍵和值的項目的類別。

w6fwh89e.collapse_all(zh-tw,VS.110).gifCPair 資料成員

名稱

描述

CAtlMap::CPair::m_key

儲存金鑰字元的資料成員。

CAtlMap::CPair::m_value

將值儲存項目的資料成員。

w6fwh89e.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CAtlMap::CAtlMap

建構函式。

CAtlMap::~CAtlMap

解構函式。

w6fwh89e.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

CAtlMap::AssertValid

呼叫這個方法會判斷提示 CAtlMap 是否無效。

CAtlMap::DisableAutoRehash

呼叫這個方法會停用自動重新複合 CAtlMap 物件。

CAtlMap::EnableAutoRehash

呼叫這個方法會啟用自動重新複合 CAtlMap 物件。

CAtlMap::GetAt

呼叫這個方法會傳回這個項目是在對應中指定的位置。

CAtlMap::GetCount

呼叫這個方法會擷取項目數目對應的。

CAtlMap::GetHashTableSize

呼叫這個方法會設定容器的數目對應的雜湊資料表中。

CAtlMap::GetKeyAt

呼叫這個方法會擷取金鑰儲存在 CAtlMap 物件的指定位置。

CAtlMap::GetNext

呼叫這個方法以取得指向在 CAtlMap 物件中的下一個項目為。

CAtlMap::GetNextAssoc

取得可逐一查看的下一個項目。

CAtlMap::GetNextKey

呼叫這個方法會從物件擷取 CAtlMap 下的機碼。

CAtlMap::GetNextValue

呼叫這個方法會從 CAtlMap 物件取得下一個值。

CAtlMap::GetStartPosition

呼叫這個方法會啟動對應反覆項目。

CAtlMap::GetValueAt

呼叫這個方法會擷取值儲存在 CAtlMap 物件的指定位置。

CAtlMap::InitHashTable

呼叫這個方法會初始化雜湊資料表。

CAtlMap::IsEmpty

呼叫這個方法測試是否為空的對應物件。

CAtlMap::Lookup

呼叫這個方法會查閱索引鍵或值。 CAtlMap 物件。

CAtlMap::Rehash

呼叫這個方法會將 CAtlMap 至物件。

CAtlMap::RemoveAll

呼叫這個方法會從 CAtlMap 物件移除所有項目。

CAtlMap::RemoveAtPos

呼叫這個方法會移除這個項目是在 CAtlMap 物件的指定位置。

CAtlMap::RemoveKey

呼叫這個方法會從物件移除項目 CAtlMap 指定關鍵值。

CAtlMap::SetAt

呼叫這個方法插入項目至至對應。

CAtlMap::SetOptimalLoad

呼叫這個方法會設定物件的 CAtlMap 最佳載入。

CAtlMap::SetValueAt

呼叫這個方法會將值儲存在 CAtlMap 物件的指定位置。

w6fwh89e.collapse_all(zh-tw,VS.110).gif公用運算子

名稱

描述

CAtlMap::operator []

取代或加入新的項目加入至 CAtlMap

備註

CAtlMap 為對應的任何指定型別的支援,處理未按順序的主要項目和其關聯的值。 項目 (包含索引鍵和值) 使用雜湊演算法,儲存,允許大量資料有效率地儲存和擷取。

KTraits 和 VTraits 參數是包含必要的所有補充程式碼複製或移動項目特性類別。

CRBMap 類別提供對 CAtlMap 的選項。 也CRBMap 儲存索引鍵/值組,但是,只顯示不同的效能特性。 所花費的時間插入項目,查閱索引鍵或刪除 CRBMap 物件中的索引鍵是命令記錄 (n),其中 n 是中的項目數。 如需 CAtlMap,這些作業通常會花費常數時間,不過,最壞的情況可能是順序 n。 因此,在典型的案例中, CAtlMap 速度較快。

在逐一查看中的項目時,在 CRBMapCAtlMap 之間的另一個差異很明顯。 在 CRBMap,項目排序順序已瀏覽過的。 在 CAtlMap,項目不會進行排序,且順序,不可以推斷。

當需要儲存時有少數項目,請考慮使用 CSimpleMap 類別。

如需詳細資訊,請參閱 ATL 集合類別。

需求

Header: atlcoll.h

請參閱

概念

Marquee 範例

UpdatePV 範例

其他資源

ATL 類別概觀