CStringArray

CStringArray的成員函式類似於CObArray類的成員函式。

基本介紹

• 外文名：CStringArray
• 性質：科學
• 類別：計算機

程式簡介

CStringArray類支持CString對象數組。由於具有這些相似性，你可以參考關於CObArray的寒巴滲參考檔案來獲取CStringArray成員函式的詳細說明。如果在說明中看到某一函式的返回值是一個指向CObject對象的指針，則可以用一個CString（而不是一個CString指針）來代替它。如果看到某一函式的參數是一個指向CObject的指針，則可以用LPCTSTR來代替它。

舉例說明

例如，可以將

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

轉換為

CString CStringArray::GetAt( int <nIndex> ) const;

和將

void SetAt( int <nIndex>, CObject* <newElement> )

轉換為

void SetAt( int <nIndex>, LPCTSTR <newElement> );

CStringArray與IMPLEMENT_SERIAL宏聯合起來支持其元素的連續和轉儲。如果一個CString對象數組被用一個重載的插入操作符或Serialize成員函式保存到一個存檔中，則它的每一個元素都按順序連續。

注意：

在使用一個數組之前，使用SetSize來建立它的大小並給它分配記憶體。如果你不使用SetSize，則向數組中添加元素時將導致數組被頻繁地拷貝和分配記憶體。頻繁分配記憶體和拷貝會導致效率低和記憶體備殃雅零碎。

如果你需要數組中個別字元串元素的良汽洪棄轉儲，則應該將轉儲環境的深度設定為1或更大。當一個CString數組被刪除時，或當其中的個別元素被刪除時，字元串記憶體會根據需要釋放。

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

#include <afxcoll.h>

CStringArray類成員

構造

CStringArray構造一個空的CString對象數組

綁定

GetSize 獲取這個數腿設恥諒組中的元素數目 SetSize 設定這個數組辨幾中包含的元素數目 GetUpperBound 返回最大的有效索引

操作符

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

元素訪問

GetAt 返回位於給定索引處的值 SetAt 設定給定索引處的元素的值；不得將數組增大 ElementAt 返回對數組中的某一元素指針的臨時引用 GetData 對數組中的元素允許的訪問。可朽估凶以是NULL

擴大數組

SetAtGrow 設定給定索引處的值，如果必要的話可以增長數組 Add 在數組的末尾添加一個元素；可根據需要增長數組 Append 向數組中添加另一個數組；如果必要的話可增長數寒埋只組 Copy 將另一個數組拷貝到此數組中；如果必要的話可增長數組

插入/刪除

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

操作符

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