CUIntArray

CUIntArray

CObject

└CUIntArray

CUIntArray類支持無符號整數數組。一個無符號的整數，或UINT，與字和雙字是不一樣的，一個UINT的物理大小可以根據目標操作環境而改變。在Windows 3.1版下，一個UINT與一個WORD的大小是一樣的。在Windows NT和Windows 95下，一個UINT的大小與一個雙字一樣大。

CUIntArray的成員函式類似於類CObArray的成員函式。由於這個相似性，你可以使用特定成員函式的CObArray引用檔案。在你看見一個CObject指針作為函式參數或返回值的地方，用一個UINT來代替。例如：

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

可以被轉換為

UINT CUIntArray::GetAt( int <nIndex> ) const;

CUIntArray與IMPLEMENT_DYNAMIC宏一起支持運行時類型訪問和轉儲到一個CDumpContext對象。如果你需要單個無符號整數元素的轉儲，你必須將轉儲環境的深度設定為1或更大。無符號整數數組不能被連續。

注意：

在使用一個數組之前，使用SetSize來建立它的大小並給它分配記憶體。如果你不使用SetSize，當向你的數組添加元素時會導致頻繁地重定位和拷貝。頻繁的重定位和拷貝會降低效率並產生記憶體碎片。

有關使用CUIntArray的更多信息，參見“Visual C++程式設計師指南”中的文章“集合”。

#include <afxcoll.h>

CUIntArray類成員

構造

CUIntArray 構造一個無符號整數的空數據

綁定

GetSize 獲取此數組中的元素的數目 SetSize 設定包含在此數組中的元素數目 GetUpperBound 獲取最大的有效索引

操作

FreeExtra 釋放在當前上邊界之上的所有沒有使用的記憶體 RemoveAll 從此數組中刪除所有的元素

元素訪問

GetAt 返回一個給定索引處的值 SetAt 設定一個給定索引的值，不允許數組增長 ElementAt 返回一個對數組中的元素指針的臨時引用 GetData 允許訪問數組中的元素。可以是NULL

增加數組

SetAtGrow 設定一個給定索引的值。允許數組的必要增長 Add 在數組的最後添加一個元素，允許數組的必要增長 Append 給此數組添加另一個數組，允許數組的必要增長 Copy 將另一個數組拷貝到該數組，允許數組的必要增長

插入/刪除

InsertAt 在指定索引處插入一個元素（或另一個數組中的所有元素） RemoveAt 刪除指定索引處的元素

操作符

operator [] 設定或獲取指定索引處的元素