CStringArray 類別

發行項
06/10/2015

支援 CString 物件的陣列。

class CStringArray : public CObject

Members

CStringArray 的成員函式類似於 CObArray 類別的成員函式。由於此相似性，您可以針對成員函式特性使用 CObArray 參考文件。無論在何處看到 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> )

公用建構函式

名稱	描述
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]	設定或取得指定索引處的項目。

備註

CStringArray 引入 IMPLEMENT_SERIAL 巨集，以支援其項目的序列化和傾印。如果 CString 物件的陣列儲存至封存檔，請使用多載插入運算子或 Serialize 成員函式，依次對每一個項目進行序列化。

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

如果您需要傾印陣列中的個別字串項目，則您必須將傾印內容的深度設定為 1 或更大。

當刪除 CString 陣列，或者移除其項目時，會適當地釋放字串記憶體。

如需使用 CStringArray 的詳細資訊，請參閱文章集合。

繼承階層

CObject

CStringArray

需求

**標頭：**afxcoll.h

請參閱

參考

CObject 類別

階層架構圖表

共用方式為