CDWordArray Class

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

支援 32 位元雙字組陣列。

class CDWordArray : public CObject  

成員函式CDWordArray類別的成員函式類似CObArray。 由於此相似性,您可以針對成員函式特性使用 CObArray 參考文件。 無論在何處看到CObject指標做為函式參數或傳回值,取代DWORD

CObject* CObArray::GetAt( int <nIndex> ) const;

例如,轉換為

DWORD CDWordArray::GetAt( int <nIndex> ) const;

公用建構函式

名稱說明
CObArray::CObArray建構空陣列。

公用方法

名稱說明
CObArray::Add將項目加入至陣列結尾;必要時讓陣列增長。
CObArray::Append將其他陣列附加至該陣列;必要時讓陣列成長。
CObArray::Copy將其他陣列複製到該陣列;必要時讓陣列成長。
CObArray::ElementAt傳回的位元組陣列中的臨時參考。
CObArray::FreeExtra釋放超過目前上限的所有未使用記憶體。
CObArray::GetAt傳回給定索引的值。
CObArray::GetCount取得此陣列中項目的數目。
CObArray::GetData容許存取陣列中的項目。 可以是NULL
CObArray::GetSize取得此陣列中項目的數目。
CObArray::GetUpperBound傳回最大的有效索引。
CObArray::InsertAt在指定索引處插入項目 (或其他陣列中的所有項目)。
CObArray::IsEmpty判定陣列是否是空的。
CObArray::RemoveAll從此陣列移除所有項目。
CObArray::RemoveAt移除特定索引處的項目。
CObArray::SetAt設定給定索引的值;不容許陣列成長。
CObArray::SetAtGrow設定給定索引的值;必要時讓陣列成長。
CObArray::SetSize設定此陣列中要包含的項目數目。

公用運算子

名稱說明
[CObArray::operator]](../Topic/CObArray%20Class.md#cobarray__operator_at)設定或取得指定索引處的項目。

CDWordArray 引入 IMPLEMENT_SERIAL 巨集,以支援其項目的序列化和傾印。 如果雙字組的陣列儲存至封存檔,也能提供多載的插入 ( ** << **) 運算子或Serialize成員函式,每個項目,換句話說,序列化。

System_CAPS_ICON_note.jpg 注意

使用陣列之前,請先使用 SetSize 建立其大小,並為其配置記憶體。 如果您未使用 SetSize,則將項目加入至陣列會導致其被頻繁地重新配置及複製。 頻繁的重新配置及複製效率不高,且可能會讓記憶體分段。

如果您需要偵錯輸出陣列中的個別項目,您必須設定的深度CDumpContext為 1 或更高的物件。

如需有關使用CDWordArray,請參閱文章集合

標頭︰ afxcoll.h

CObject 類別
階層架構圖表
CObArray 類別

顯示: